get https://api.amberdata.com/markets/spot/exchanges/reference
Returns essential reference details for Spot market trading pairs on supported exchanges, including symbols, market status, price and volume limits, cost and leverage constraints, precision requirements, and listing metadata.
⚠️ IMPORTANT UPDATE ⚠️
Important Update
The old endpoint
https://api.amberdata.com/market/spot/exchanges/referencehas been updated tohttps://api.amberdata.com/markets/spot/exchanges/referenceand is no longer being supported. Please update your integrations accordingly.See changes here
- Endpoint URL Change:
- Old:
https://api.amberdata.com/market/spot/exchanges/reference- New:
https://api.amberdata.com/markets/spot/exchanges/reference- Metadata Changes:
api-versionfield added to the response- Data Structure Changes:
- The old schema
datastructure was a nested JSON object with exchanges and instruments- The new schema
datastructure is an array of JSON objects, each representing an exchange and instrument with detailed information- Field Value Changes:
pairquery parameter is now calledinstrument- New fields added:
exchange,instrument,market,listingTimestampexchangeEnabled: New field replacingactivelimitsPriceMin: Replaceslimits_price_minlimitsPriceMax: Replaceslimits_price_maxlimitsVolumeMin: New field replacinglimits_amount_minlimitsVolumeMax: New field replacinglimits_amount_maxlimitsMarketMin: Replaceslimits_market_minlimitsMarketMax: Replaceslimits_market_maxlimitsLeverageMin: Replaceslimits_leverage_minlimitsLeverageMax: Replaceslimits_leverage_maxlimitsLeverageSuperMax: Replaceslimits_leverage_superMaxlimitsCostMin: Replaceslimits_cost_minlimitsCostMax: Replaceslimits_cost_maxprecisionPrice: Replacesprecision_priceprecisionVolume:New field replacingprecision_amount- Other
- Include the
Accept-Encoding:header in your API requests to take advantage of compressed responses.
Note:
By default, instrument names are normalized to the "base_quote" format. If you wish to see the original exchange-native instrument names and details, set the
includeOriginalReferenceparameter totruein your request. The response will then include an originalReference object with the exchange's native data for each instrument.
RESPONSE DATA
| JSON Field/Path | Value Type | Description |
|---|---|---|
| payload.metadata.next | number | The URL for the next page of results, if there are more results to fetch. It is a paginated cursor that allows the client to retrieve the next set of data. |
| payload.metadata.api-version | string | The version of the API being used, indicated as a date string. |
| payload.data[{index}].exchange | string | The name of the exchange, such as "binance." |
| payload.data[{index}].instrument | string | The trading pair or instrument being referenced, such as "btc_usd." |
| payload.data[{index}].baseSymbol | string | The symbol of the base currency in the trading pair, such as "BTC." |
| payload.data[{index}].quoteSymbol | string | The symbol of the quote currency in the trading pair, such as "USD." |
| payload.data[{index}].market | string | The market type, such as "spot." |
| payload.data[{index}].exchangeEnabled | boolean | Indicates whether the trading pair is enabled on the exchange. |
| payload.data[{index}].limitsPriceMin | number | The minimum price limit for the trading pair. |
| payload.data[{index}].limitsPriceMax | number | The maximum price limit for the trading pair. |
| payload.data[{index}].limitsVolumeMin | number | The minimum volume limit for the trading pair. |
| payload.data[{index}].limitsVolumeMax | number | The maximum volume limit for the trading pair. |
| payload.data[{index}].limitsMarketMin | number | The minimum market order size limit for the trading pair. |
| payload.data[{index}].limitsMarketMax | number | The maximum market order size limit for the trading pair. |
| payload.data[{index}].limitsLeverageMin | number | The minimum leverage limit for the trading pair. If null, leverage is not applicable. |
| payload.data[{index}].limitsLeverageMax | number | The maximum leverage limit for the trading pair. If null, leverage is not applicable. |
| payload.data[{index}].limitsLeverageSuperMax | number | The maximum super leverage limit for the trading pair. If null, super leverage is not applicable. |
| payload.data[{index}].limitsCostMin | number | The minimum cost limit for the trading pair. |
| payload.data[{index}].limitsCostMax | number | The maximum cost limit for the trading pair. If null, no maximum cost limit is set. |
| payload.data[{index}].precisionPrice | number | The precision level for the price of the trading pair. |
| payload.data[{index}].precisionVolume | number | The precision level for the volume of the trading pair. |
| payload.data[{index}].precisionBase | number | The precision level for the base currency of the trading pair. |
| payload.data[{index}].precisionQuote | number | The precision level for the quote currency of the trading pair. |
| payload.data[{index}].listingTimestamp | number | The timestamp when the trading pair was listed on the exchange. If null, the listing date is not available. |