QuantSynergy API Documentation

Version 1.0.0

Base URL: https://api.quantsynergy.xyz/api

Introduction

QuantSynergy API provides programmatic access to real-time and historical cryptocurrency market data, advanced quantitative metrics, and multi-exchange aggregation services. Our API enables developers to build sophisticated trading applications, analytics dashboards, and financial services platforms.

Key Features

  • Real-time Market Data: Live prices, volumes, and market metrics from multiple exchanges
  • Historical Data: OHLCV candlestick data with multiple timeframes
  • Multi-Exchange Aggregation: Unified data from Binance, Bybit, Bitget, and Kraken
  • Advanced Analytics: Quantitative metrics, correlation analysis, and market dynamics
  • Futures Data: Open interest and funding rates across exchanges
Note: All API endpoints require authentication. See the Authentication section for details.

Authentication

QuantSynergy API uses API Key authentication. All requests must include valid authentication headers.

Getting Your API Key

Once registered on QuantSynergy, go to your Account Settings to find your Free tier API key, which is automatically generated when you create your account.

Request Headers

All API requests must include:

HeaderRequiredDescription
AuthorizationYesAPI Key: YOUR_API_KEY
X-API-SecretYesYour API secret key
Content-TypeYes (POST/PUT)application/json

Example Request

curl -X GET "https://api.quantsynergy.xyz/api/currencies" \
  -H "Authorization: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"
Important: When a new API key is generated, the secret is shown only once. Save it immediately. If you lose it, you'll need to generate a new key.

Rate Limits

To ensure fair usage and system stability, QuantSynergy API implements rate limiting on all endpoints.

TierRequests per MinuteRequests per HourRequests per Day
Free110100
Professional (Available on request)30010,000100,000
Enterprise (Available on request)1,00050,000500,000

When you exceed your rate limit, you'll receive a 429 Too Many Requests response. Implement exponential backoff when receiving 429 responses.

Note: Professional and Enterprise tiers are not yet available and are available only upon request. If you're interested, please contact us to discuss your specific needs.

Currencies API

List Currencies

Retrieve a list of all available cryptocurrencies with real-time prices and market data.

GET/currencies

Query Parameters

ParameterTypeRequiredDefaultDescription
exchangestringNoallFilter by exchange: binance, bybit, bitget, kraken, all

Example Request

curl -X GET "https://api.quantsynergy.xyz/api/currencies?exchange=all" \
  -H "Authorization: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"

Get Markets (Paginated)

Retrieve paginated market data with comprehensive cryptocurrency information. Results are automatically sorted by market cap in descending order.

GET/currencies/markets

Query Parameters

ParameterTypeRequiredDefaultDescription
pageintegerNo1Page number (starts at 1)
per_pageintegerNo100Items per page (max: 100)
exchangestringNoallFilter by exchange: binance, bybit, bitget, kraken, all

Example Request

curl -X GET "https://api.quantsynergy.xyz/api/currencies/markets?page=1&per_page=100&exchange=all" \
  -H "Authorization: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"

Get Global Market Cap

Retrieve global cryptocurrency market cap with 7-day trend data.

GET/currencies/global-market-cap

Example Request

curl -X GET "https://api.quantsynergy.xyz/api/currencies/global-market-cap" \
  -H "Authorization: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"

Get Sparkline Data

Retrieve 7-day sparkline price data for a specific cryptocurrency.

GET/currencies/sparklines/:symbol

Path Parameters

ParameterTypeRequiredDescription
symbolstringYesCryptocurrency symbol (e.g., BTC)

Example Request

curl -X GET "https://api.quantsynergy.xyz/api/currencies/sparklines/BTC" \
  -H "Authorization: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"

Batch Sparkline Data

Retrieve sparkline data for multiple cryptocurrencies in a single request.

POST/currencies/sparklines-batch

Request Body

{
  "symbols": ["BTC", "ETH", "ADA", "SOL"]
}

Example Request

curl -X POST "https://api.quantsynergy.xyz/api/currencies/sparklines-batch" \
  -H "Authorization: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"symbols": ["BTC", "ETH", "ADA"]}'

Pair API

Get OHLCV Data

Retrieve historical OHLCV (Open, High, Low, Close, Volume) candlestick data for a trading pair.

GET/pair

Query Parameters

ParameterTypeRequiredDefaultDescription
basestringYes-Base currency (e.g., BTC)
quotestringYes-Quote currency (e.g., USDT)
timeframestringNo1dTimeframe: 5m, 15m, 30m, 1h, 4h, 1d, 1w, 1M
exchangestringNobinanceExchange: binance, bybit, bitget, kraken, all
volumeTypestringNobaseVolume type: base, quote
fullHistorybooleanNotrueReturn full available history

Example Request

curl -X GET "https://api.quantsynergy.xyz/api/pair?base=BTC&quote=USDT&timeframe=1d&exchange=binance&fullHistory=true" \
  -H "Authorization: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"
Note: For synthetic pairs (e.g., AVAX/SOL), the API automatically calculates the pair price by dividing the base currency price by the quote currency price from aggregated exchange data.

Markets API

Get Real-Time Prices

Retrieve real-time prices for all or specific cryptocurrencies.

GET/markets

Query Parameters

ParameterTypeRequiredDefaultDescription
exchangestringNoallFilter by exchange
symbolstringNo-Specific cryptocurrency symbol

Example Request

curl -X GET "https://api.quantsynergy.xyz/api/markets?symbol=BTC" \
  -H "Authorization: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"

Compare Prices Across Exchanges

Compare prices for a cryptocurrency across all supported exchanges.

GET/markets/compare/:symbol

Path Parameters

ParameterTypeRequiredDescription
symbolstringYesCryptocurrency symbol

Example Request

curl -X GET "https://api.quantsynergy.xyz/api/markets/compare/BTC" \
  -H "Authorization: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"

Get Market Statistics

Retrieve statistics about market coverage and exchange distribution.

GET/markets/stats

Example Request

curl -X GET "https://api.quantsynergy.xyz/api/markets/stats" \
  -H "Authorization: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"

Synergy Metrics API

Get Comprehensive Metrics

Retrieve comprehensive quantitative metrics and market analysis for a cryptocurrency.

GET/synergy-metrics/comprehensive/:symbol

Path Parameters

ParameterTypeRequiredDescription
symbolstringYesCryptocurrency symbol

Example Request

curl -X GET "https://api.quantsynergy.xyz/api/synergy-metrics/comprehensive/BTC" \
  -H "Authorization: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"

Get Futures Data (All Exchanges)

Retrieve aggregated futures data (open interest and funding rates) from all supported exchanges.

GET/synergy-metrics/futures/all-exchanges

Query Parameters

ParameterTypeRequiredDefaultDescription
symbolstringNo-Filter by specific symbol

Example Request

curl -X GET "https://api.quantsynergy.xyz/api/synergy-metrics/futures/all-exchanges?symbol=BTC" \
  -H "Authorization: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"

Datafeed API (TradingView Integration)

The Datafeed API provides TradingView UDF (Universal Data Feed) compatibility for integrating QuantSynergy data with TradingView charts.

Get Configuration

Retrieve TradingView UDF datafeed configuration.

GET/datafeed/config

Example Request

curl -X GET "https://api.quantsynergy.xyz/api/datafeed/config" \
  -H "Authorization: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"

Get Historical Data

Retrieve historical OHLCV data in TradingView format.

GET/datafeed/history

Query Parameters

ParameterTypeRequiredDescription
symbolstringYesTrading pair (e.g., BTCUSDT)
fromintegerYesStart timestamp (Unix seconds)
tointegerYesEnd timestamp (Unix seconds)
resolutionstringYesResolution: 5, 15, 30, 60, 240, D, W, M

Example Request

curl -X GET "https://api.quantsynergy.xyz/api/datafeed/history?symbol=BTCUSDT&from=1705276800&to=1705363200&resolution=D" \
  -H "Authorization: YOUR_API_KEY" \
  -H "X-API-Secret: YOUR_API_SECRET"

Error Handling

All API errors follow a consistent format:

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message",
    "details": {
      "field": "additional error details"
    }
  }
}

HTTP Status Codes

CodeDescription
200Success
400Bad Request - Invalid parameters
401Unauthorized - Invalid or missing authentication
403Forbidden - Insufficient permissions
404Not Found - Resource not found
429Too Many Requests - Rate limit exceeded
500Internal Server Error - Server error

Error Codes

CodeDescription
AUTHENTICATION_FAILEDInvalid API key or secret
AUTHENTICATION_REQUIREDMissing authentication headers
INVALID_PARAMETERInvalid or missing required parameter
RATE_LIMIT_EXCEEDEDRate limit exceeded
RESOURCE_NOT_FOUNDRequested resource not found
EXCHANGE_NOT_SUPPORTEDExchange not supported
SYMBOL_NOT_FOUNDCryptocurrency symbol not found