openapi: 3.2.0
info:
title: Amberdata Exchanges API
version: '2'
description: 'Operations tagged Exchanges across 2 of this provider''s published API definitions: amberdata-arc-openapi.yaml, amberdata-metrics-openapi.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.amberdata.com/arc
- url: https://api.amberdata.com/market/metrics
security:
- sec0: []
tags:
- name: Exchanges
paths:
/exchanges/statistics:
get:
summary: Exchange Statistics
description: Retrieve the **latest** known instruments statistics from exchanges that Amberdata supports.
operationId: asset-reference-classification-exchange-statistics
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value:
status: 200
title: OK
description: Successful request
payload:
metadata:
next: null
data:
lastUpdatedAt: 1733246810233
totalExchanges: 22
totalInstrumentsSpot: 22629
byExchange:
- exchange: binance
instrumentsSpot: 2832
- exchange: binanceus
instrumentsSpot: 549
- exchange: bitfinex
instrumentsSpot: 1428
- exchange: bitget
instrumentsSpot: 991
- exchange: bithumb
instrumentsSpot: 617
- exchange: bitmex
instrumentsSpot: 20
- exchange: bitstamp
instrumentsSpot: 271
- exchange: bybit
instrumentsSpot: 751
- exchange: cboedigital
instrumentsSpot: 10
- exchange: ftx
instrumentsSpot: 621
- exchange: ftxus
instrumentsSpot: 67
- exchange: gdax
instrumentsSpot: 721
- exchange: gemini
instrumentsSpot: 274
- exchange: huobi
instrumentsSpot: 1905
- exchange: itbit
instrumentsSpot: 14
- exchange: kraken
instrumentsSpot: 1350
- exchange: lmax
instrumentsSpot: 46
- exchange: mercadobitcoin
instrumentsSpot: 701
- exchange: mexc
instrumentsSpot: 5853
- exchange: okex
instrumentsSpot: 1283
- exchange: poloniex
instrumentsSpot: 1686
- exchange: zb
instrumentsSpot: 639
schema:
type: object
properties:
status:
type: integer
example: 200
default: 0
title:
type: string
example: OK
description:
type: string
example: Successful request
payload:
type: object
properties:
metadata:
type: object
properties:
next: {}
data:
type: object
properties:
lastUpdatedAt:
type: integer
example: 1733246810233
default: 0
totalExchanges:
type: integer
example: 22
default: 0
totalInstrumentsSpot:
type: integer
example: 22629
default: 0
byExchange:
type: array
items:
type: object
properties:
exchange:
type: string
example: binance
instrumentsSpot:
type: integer
example: 2832
default: 0
deprecated: false
tags:
- Exchanges
servers:
- url: https://api.amberdata.com/arc
/exchanges/{exchange}/assets/volumes/historical:
get:
summary: Asset Volume Historical
description: 'Retrieves the daily volume of assets on each exchange.
***Note**: This endpoint excludes data from LMAX.'
operationId: market-metrics-exchanges-assets-volumes-historical
parameters:
- name: exchange
in: path
description: The exchange for which to retrieve the requested data.
schema:
type: string
default: gdax
required: true
- name: asset
in: query
description: '**[Optional]** The asset for which to retrieve the most current data.
**[Default]** All available assets.'
schema:
type: string
default: btc
- name: quoteVolume
in: query
description: '**[Optional]** Aggregate on quote volume instead of base volume.'
schema:
type: boolean
default: false
- name: direction
in: query
description: '**[Optional]** The order in which to return the results, ordered by volumeUSD (ascending or descending). By default, records are returned in descending order, so the records with the largest volume are returned first.'
schema:
type: string
default: desc
- name: startDate
in: query
description: '**[Optional]** Payload only includes data after this date (inclusive).
**[Formats]** `seconds | milliseconds | iso8601`
**[Examples]** `1578531600 | 1578531600000 | 2020-09-01T01:00:00`'
schema:
type: string
- name: endDate
in: query
description: '**[Optional]** Payload only includes data before this date (exclusive).
**[Formats]** `seconds | milliseconds | iso8601`
**[Examples]** `1578531600 | 1578531600000 | 2020-09-01T01:00:00`'
schema:
type: string
- name: timeFormat
in: query
description: '**[Optional]** Time format of the timestamps in the return payload.
**[Defaults]** `milliseconds | ms* | iso | iso8601 | hr | human_readable`'
schema:
type: string
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value:
status: 200
title: OK
description: Successful request
payload:
metadata:
startDate: 2022-03-10 00:00:00 000
endDate: 2022-03-11 10:00:00 000
data:
- exchange: gdax
asset: btc
timestamp: 2022-03-10 00:00:00 000
volumeUSD: '1029206608.30715038'
- exchange: gdax
asset: btc
timestamp: 2022-03-11 00:00:00 000
volumeUSD: '767275182.09255630'
schema:
type: object
properties:
status:
type: integer
example: 200
default: 0
title:
type: string
example: OK
description:
type: string
example: Successful request
payload:
type: object
properties:
metadata:
type: object
properties:
startDate:
type: string
example: 2022-03-10 00:00:00 000
endDate:
type: string
example: 2022-03-11 10:00:00 000
data:
type: array
items:
type: object
properties:
exchange:
type: string
example: gdax
asset:
type: string
example: btc
timestamp:
type: string
example: 2022-03-10 00:00:00 000
volumeUSD:
type: string
example: '1029206608.30715038'
deprecated: false
tags:
- Exchanges
servers:
- url: https://api.amberdata.com/market/metrics
/exchanges/{exchange}/pairs/volumes/historical:
get:
summary: Pair Volume Historical
description: Retrieves the daily volume of pairs on each exchange.
operationId: market-metrics-exchanges-pairs-volumes-historical
parameters:
- name: exchange
in: path
description: The exchange for which to retrieve the requested data.
schema:
type: string
default: gdax
required: true
- name: pair
in: query
description: '**[Optional]** The pair for which to retrieve the most current data.
**[Default]** All available pairs.'
schema:
type: string
default: btc_usd
- name: direction
in: query
description: '**[Optional]** The order in which to return the results, ordered by volumeUSD (ascending or descending). By default, records are returned in descending order, so the records with the largest volume are returned first.'
schema:
type: string
default: desc
- name: startDate
in: query
description: '**[Optional]** Payload only includes data after this date (inclusive).
**[Formats]** `seconds | milliseconds | iso8601`
**[Examples]** `1578531600 | 1578531600000 | 2020-09-01T01:00:00`'
schema:
type: string
- name: endDate
in: query
description: '**[Optional]** Payload only includes data before this date (exclusive).
**[Formats]** `seconds | milliseconds | iso8601`
**[Examples]** `1578531600 | 1578531600000 | 2020-09-01T01:00:00`'
schema:
type: string
- name: timeFormat
in: query
description: '**[Optional]** Time format of the timestamps in the return payload.
**[Defaults]** `milliseconds | ms* | iso | iso8601 | hr | human_readable`'
schema:
type: string
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value:
status: 200
title: OK
description: Successful request
payload:
metadata:
startDate: 2022-03-10 00:00:00 000
endDate: 2022-03-11 10:00:00 000
data:
- exchange: gdax
pair: btc_usd
timestamp: 2022-03-10 00:00:00 000
volumeUSD: '820976607.01839280'
- exchange: gdax
pair: btc_usd
timestamp: 2022-03-11 00:00:00 000
volumeUSD: '616422583.44034633'
schema:
type: object
properties:
status:
type: integer
example: 200
default: 0
title:
type: string
example: OK
description:
type: string
example: Successful request
payload:
type: object
properties:
metadata:
type: object
properties:
startDate:
type: string
example: 2022-03-10 00:00:00 000
endDate:
type: string
example: 2022-03-11 10:00:00 000
data:
type: array
items:
type: object
properties:
exchange:
type: string
example: gdax
pair:
type: string
example: btc_usd
timestamp:
type: string
example: 2022-03-10 00:00:00 000
volumeUSD:
type: string
example: '820976607.01839280'
deprecated: false
tags:
- Exchanges
servers:
- url: https://api.amberdata.com/market/metrics
/exchanges/{exchange}/pairs/volumes/latest:
get:
summary: Pair Volume Latest
description: Retrieves the daily volume of pairs on each exchange over a rolling 24h period, updated hourly. The timestamp returned represents the beginning of the daily bar, following the same approach as OHLCV.
operationId: market-metrics-exchanges-pairs-volumes-latest
parameters:
- name: exchange
in: path
description: The exchange for which to retrieve the requested data.
schema:
type: string
default: gdax
required: true
- name: pair
in: query
description: '**[Optional]** The pair for which to retrieve the most current data (ie. btc_usd, eth_usd, etc.).
**[Default]** All available pairs.'
schema:
type: string
- name: direction
in: query
description: '**[Optional]** The order in which to return the results, ordered by volumeUSD (ascending or descending). By default, records are returned in descending order, so the records with the largest volume are returned first.'
schema:
type: string
default: desc
- name: timeFormat
in: query
description: '**[Optional]** Time format of the timestamps in the return payload.
**[Defaults]** `milliseconds | ms* | iso | iso8601 | hr | human_readable`'
schema:
type: string
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value:
status: 200
title: OK
description: Successful request
payload:
data:
- exchange: gdax
pair: btc_usd
timestamp: 2022-03-13 14:00:00 000
volumeUSD: '417084146.60114834'
schema:
type: object
properties:
status:
type: integer
example: 200
default: 0
title:
type: string
example: OK
description:
type: string
example: Successful request
payload:
type: object
properties:
data:
type: array
items:
type: object
properties:
exchange:
type: string
example: gdax
pair:
type: string
example: btc_usd
timestamp:
type: string
example: 2022-03-13 14:00:00 000
volumeUSD:
type: string
example: '417084146.60114834'
deprecated: false
tags:
- Exchanges
servers:
- url: https://api.amberdata.com/market/metrics
/exchanges/{exchange}/assets/volumes/latest:
get:
summary: Asset Volume Latest
description: 'Retrieves the daily volume of assets on each exchange over a rolling 24h period, updated hourly. The timestamp returned represents the beginning of the daily bar, following the same approach as OHLCV. **Note**: This endpoint excludes data from LMAX.'
operationId: market-metrics-exchanges-assets-volumes-latest
parameters:
- name: exchange
in: path
description: The exchange for which to retrieve the requested data.
schema:
type: string
default: gdax
required: true
- name: asset
in: query
description: '**[Optional]** The asset for which to retrieve the most current data (ie. btc, eth, etc.)
**[Default]** All available assets.'
schema:
type: string
- name: quoteVolume
in: query
description: '**[Optional]** Aggregate on quote volume instead of base volume.'
schema:
type: boolean
default: false
- name: direction
in: query
description: '**[Optional]** The order in which to return the results, ordered by volumeUSD (ascending or descending). By default, records are returned in descending order, so the records with the largest volume are returned first.'
schema:
type: string
default: desc
- name: timeFormat
in: query
description: '**[Optional]** Time format of the timestamps in the return payload.
**[Defaults]** `milliseconds | ms* | iso | iso8601 | hr | human_readable`'
schema:
type: string
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value:
status: 200
title: OK
description: Successful request
payload:
data:
- exchange: gdax
asset: btc
timestamp: 2022-03-13 14:00:00 000
volumeUSD: '520426096.98878671'
schema:
type: object
properties:
status:
type: integer
example: 200
default: 0
title:
type: string
example: OK
description:
type: string
example: Successful request
payload:
type: object
properties:
data:
type: array
items:
type: object
properties:
exchange:
type: string
example: gdax
asset:
type: string
example: btc
timestamp:
type: string
example: 2022-03-13 14:00:00 000
volumeUSD:
type: string
example: '520426096.98878671'
deprecated: false
tags:
- Exchanges
servers:
- url: https://api.amberdata.com/market/metrics
components:
securitySchemes:
sec0:
type: apiKey
in: header
name: x-api-key
x-default: API_KEY
x-refined-from:
- amberdata-arc-openapi.yaml
- amberdata-metrics-openapi.yaml
x-readme:
headers: []
explorer-enabled: true
proxy-enabled: true
x-readme-fauxas: true