Amberdata Price API
Latest and historical global asset and pair prices, VWAP, TWAP, and reference rates.
OpenAPI Specification
openapi: 3.1.0
info:
title: Pricing
version: '2'
servers:
- url: https://api.amberdata.com/markets
security:
- sec0: []
paths:
/spot/prices/assets/information/:
get:
summary: Assets Information
description: >-
Retrieves the list of all the available supported assets and time range
availability.
operationId: spot-prices-assets-information
parameters:
- name: asset
in: query
description: >-
**[Optional]** The asset for which to retrieve the information.
**[Default]** All available pairs.
schema:
type: string
default: btc
- 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
- name: includeInactive
in: query
description: >-
**[Optional]**If true, endpoint returns all pairs, including
delisted ones. **[Defaults]** `True| False*`
schema:
type: boolean
- name: Accept-Encoding
in: header
required: true
description: ''
schema:
type: string
default: gzip, deflate, br
- name: api-version
in: header
schema:
type: string
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value:
status: 200
title: OK
description: Successful request
payload:
metadata:
next: >-
https://api.amberdata.com/market/spot/prices/assets/information?cursor=N4IgLglgtgpgYgewE5QIZhALhFCAbPCAZxgGMEA7AEyJABoQAzZNDbAKyMvpAAdUA5jCwBGBkQgAvYZhEAGBQF8gA
data:
- asset: '00'
startDate: 1665446400000
endDate: 1677866100000
- asset: 1000hokk
startDate: 1621900800000
endDate: 1635811200000
- asset: 1000kishu
startDate: 1621900800000
endDate: 1652918400000
- asset: 18c
startDate: 1556064000000
endDate: 1666915200000
schema:
type: object
properties:
status:
type: integer
title:
type: string
description:
type: string
payload:
type: object
properties:
metadata:
type: object
properties:
next:
type: string
data:
type: array
items:
type: object
properties:
asset:
type: string
startDate:
type: integer
endDate:
type: integer
'400':
description: '400'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
deprecated: false
/spot/vwap/assets/{asset}/historical:
get:
summary: Assets Historical
description: >-
Retrieves the historical VWAP for the specified asset - this is the
global VWAP across all exchanges which supports this asset, including
all cross rates pairs.
Price is calculated as a volume weighted moving average across all
exchanges.
operationId: spot-vwap-assets-historical
parameters:
- name: asset
in: path
description: The asset for which to retrieve the requested data.
schema:
type: string
default: btc
required: true
- name: startDate
in: query
description: >-
**[Optional]** Payload only includes data after this date
(inclusive). <br>The interval can not exceed 12 months (d), 30 days
(h) or 24 hours (m).<br>**[Formats]** `seconds | milliseconds |
iso8601`<br>**[Examples]** `1578531600 | 1578531600000 |
2020-09-01T01:00:00`
schema:
type: string
format: date-time
- name: endDate
in: query
description: >-
**[Optional]** Payload only includes data before this date
(exclusive). <br>The interval can not exceed 12 months (d), 30 days
(h) or 24 hours (m).<br>**[Formats]** `seconds | milliseconds |
iso8601`<br>**[Examples]** `1578531600 | 1578531600000 |
2020-09-01T01:00:00`
schema:
type: string
format: date-time
- name: timeInterval
in: query
description: >-
**[Optional]** The time interval of the timeseries in the return
payload.<br/>**[Defaults]** `m* | minute | h | hour | d | day`
schema:
type: string
- name: lookbackPeriod
in: query
description: >-
**[Optional]** Number of historical data points used in the
calculation.<br/>**[Defaults]** `60 for minutely, 24 for hourly and
20 for daily`
schema:
type: integer
format: int32
- name: timeFormat
in: query
description: >-
**[Optional]** Time format of the timestamps in the return
payload.<br/>**[Defaults]** `milliseconds | ms* | iso | iso8601 | hr
| human_readable`
schema:
type: string
responses:
'200':
description: '200'
content:
application/json:
schema:
type: object
properties:
status:
type: integer
example: 200
title:
type: string
example: OK
description:
type: string
example: Successful request
payload:
type: array
items:
type: object
properties:
timestamp:
type: string
format: date-time
example: '2020-09-11T20:17:00.000Z'
asset:
type: string
example: btc
price:
type: number
format: float
example: 10334.1579
volume:
type: number
format: float
example: 3.7839
vwap:
type: number
format: float
example: 10332.5029
examples:
Result:
value:
status: 200
title: OK
description: Successful request
payload:
- timestamp: '2020-09-11T20:17:00.000Z'
asset: btc
price: 10334.1579
volume: 3.7839
vwap: 10332.5029
'400':
description: '400'
content:
application/json:
examples:
Result:
value: {}
schema:
type: object
properties: {}
deprecated: false
/spot/vwap/pairs/{pair}/historical:
get:
summary: Pairs Historical
description: >-
Retrieves the historical VWAP for the specified pair - this is the
global VWAP across all exchanges which supports this pair, including all
cross rates pairs.
Price is calculated as a volume weighted moving average across all
exchanges.
If the parameter `exchange` is specified, the data returned is the VWAP
for that pair on that exchange.
operationId: spot-vwap-pairs-historical
parameters:
- name: pair
in: path
description: The pair for which to retrieve the requested data.
schema:
type: string
default: btc_usd
required: true
- name: exchange
in: query
description: >-
**[Optional]** The exchange for which to retrieve the requested
data.<br/>Note that daily vwap is not supported with this parameter.
schema:
type: string
- name: includeCrossRates
in: query
description: >-
**[Optional]** If true, cross rate pairs are included in the price &
VWAP calculations - this option only supports pairs quoted in usd
(ie `*_usd` pairs).<br/>**[Defaults]** `false* | true`
schema:
type: boolean
- name: startDate
in: query
description: >-
**[Optional]** Payload only includes data after this date
(inclusive). <br>The interval can not exceed 12 months (d), 30 days
(h) or 24 hours (m).<br>**[Formats]** `seconds | milliseconds |
iso8601`<br>**[Examples]** `1578531600 | 1578531600000 |
2020-09-01T01:00:00`
schema:
type: string
format: date-time
- name: endDate
in: query
description: >-
**[Optional]** Payload only includes data before this date
(exclusive). <br>The interval can not exceed 12 months (d), 30 days
(h) or 24 hours (m).<br>**[Formats]** `seconds | milliseconds |
iso8601`<br>**[Examples]** `1578531600 | 1578531600000 |
2020-09-01T01:00:00`
schema:
type: string
format: date-time
- name: timeInterval
in: query
description: >-
**[Optional]** The time interval of the timeseries in the return
payload.<br/>**[Defaults]** `m* | minute | h | hour | d | day`
schema:
type: string
- name: lookbackPeriod
in: query
description: >-
**[Optional]** Number of historical data points used in the
calculation.<br/>**[Defaults]** `60 for minutely, 24 for hourly and
20 for daily`
schema:
type: integer
format: int32
- name: timeFormat
in: query
description: >-
**[Optional]** Time format of the timestamps in the return
payload.<br/>**[Defaults]** `milliseconds | ms* | iso | iso8601 | hr
| human_readable`
schema:
type: string
responses:
'200':
description: '200'
content:
application/json:
schema:
type: object
properties:
status:
type: integer
example: 200
title:
type: string
example: OK
description:
type: string
example: Successful request
payload:
type: array
items:
type: object
properties:
timestamp:
type: string
format: date-time
example: '2020-09-11T20:41:00.000Z'
pair:
type: string
example: btc_usd
price:
type: number
format: float
example: 10311.5
volume:
type: number
format: float
example: 0.1212
vwap:
type: number
format: float
example: 10315.9
examples:
Result:
value:
status: 200
title: OK
description: Successful request
payload:
- timestamp: '2020-09-11T20:41:00.000Z'
pair: btc_usd
price: 10311.5
volume: 0.1212
vwap: 10315.9
'400':
description: '400'
content:
application/json:
examples:
Result:
value: {}
schema:
type: object
properties: {}
deprecated: false
/spot/vwap/assets/information:
get:
summary: Assets Information
description: >-
Retrieves the list of all the available supported assets and time range
availability.
operationId: spot-vwap-assets-information
parameters:
- name: asset
in: query
description: >-
**[Optional]** The asset for which to retrieve the
information.<br/>**[Default]** All available pairs.
schema:
type: string
default: btc
- name: timeFormat
in: query
description: >-
**[Optional]** Time format of the timestamps in the return
payload.<br/>**[Defaults]** `milliseconds | ms* | iso | iso8601 | hr
| human_readable`
schema:
type: string
responses:
'200':
description: '200'
content:
application/json:
schema:
type: object
properties:
status:
type: integer
example: 200
title:
type: string
example: OK
description:
type: string
example: Successful request
payload:
type: object
properties:
metadata:
type: object
properties:
next:
type: string
format: uri
example: >-
https://api.amberdata.com/market/spot/vwap/assets/information?cursor=N4IgLglgtgpgYgewE5QIZhALhFCAbPCAZxgGMEA7AEyJABoQAzZNDbAKyMvpAAdUA5jCwBGBkQgAvYZhEAGBQF8gA
data:
type: array
items:
type: object
properties:
asset:
type: string
example: '00'
startDate:
type: integer
format: int64
example: 1665446400000
endDate:
type: integer
format: int64
example: 1677866100000
examples:
Result:
value:
status: 200
title: OK
description: Successful request
payload:
metadata:
next: >-
https://api.amberdata.com/market/spot/vwap/assets/information?cursor=N4IgLglgtgpgYgewE5QIZhALhFCAbPCAZxgGMEA7AEyJABoQAzZNDbAKyMvpAAdUA5jCwBGBkQgAvYZhEAGBQF8gA
data:
- asset: '00'
startDate: 1665446400000
endDate: 1677866100000
- asset: 1000hokk
startDate: 1621900800000
endDate: 1635811200000
- asset: 1000kishu
startDate: 1621900800000
endDate: 1652918400000
'400':
description: '400'
content:
application/json:
examples:
Result:
value: {}
schema:
type: object
properties: {}
deprecated: false
/spot/vwap/pairs/information:
get:
summary: Pairs Information
description: >-
Retrieves the list of all the available supported pairs and time range
availability.
operationId: spot-vwap-pairs-information
parameters:
- name: pair
in: query
description: >-
**[Optional]** The pair for which to retrieve the
information.<br/>**[Default]** All available pairs.
schema:
type: string
default: btc_usd
- name: timeFormat
in: query
description: >-
**[Optional]** Time format of the timestamps in the return
payload.<br/>**[Defaults]** `milliseconds | ms* | iso | iso8601 | hr
| human_readable`
schema:
type: string
responses:
'200':
description: '200'
content:
application/json:
schema:
type: object
properties:
status:
type: integer
example: 200
title:
type: string
example: OK
description:
type: string
example: Successful request
payload:
type: object
properties:
metadata:
type: object
properties:
next:
type: string
format: uri
example: >-
https://api.amberdata.com/market/spot/vwap/pairs/information?cursor=N4IgLglgtgpgYgewE5QIZhALhFCAbPCAZxgGMEA7AEyJABoQAzZNDbAKyMvpAAdUA5jCwBGBkQgAvYZhEAGBQF8gA
data:
type: array
items:
type: object
properties:
pair:
type: string
example: 00_usd
startDate:
type: integer
format: int64
example: 1665446400000
endDate:
type: integer
format: int64
example: 1677866100000
examples:
Result:
value:
status: 200
title: OK
description: Successful request
payload:
metadata:
next: >-
https://api.amberdata.com/market/spot/vwap/pairs/information?cursor=N4IgLglgtgpgYgewE5QIZhALhFCAbPCAZxgGMEA7AEyJABoQAzZNDbAKyMvpAAdUA5jCwBGBkQgAvYZhEAGBQF8gA
data:
- pair: 00_usd
startDate: 1665446400000
endDate: 1677866100000
- pair: '123_456'
startDate: 1581206400000
endDate: 1632873600000
- pair: 18c_btc
startDate: 1556064000000
endDate: 1666915200000
'400':
description: '400'
content:
application/json:
examples:
Result:
value: {}
schema:
type: object
properties: {}
deprecated: false
/spot/prices/assets/{asset}/latest/:
get:
summary: Assets Latest
description: >-
Retrieves the latest price for the specified asset - the global price is
calculated across all exchanges which supports this asset, including all
cross rates pairs.
Price of an asset is calculated as the VWAP (Volume Weighted Average
Price) across all exchanges supporting this asset, with a 1 bar lookback
period.
operationId: spot-prices-assets-latest
parameters:
- name: asset
in: path
description: The asset for which to retrieve the mot recent data.
schema:
type: string
default: btc
required: true
- name: timeFormat
in: query
description: >-
**[Optional]** Time format of the timestamps in the return
payload.<br/>**[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:
timestamp: '2020-09-11T22:49:00.000Z'
asset: btc
price: '10377.8883'
volume: '389.1346'
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:
timestamp:
type: string
example: '2020-09-11T22:49:00.000Z'
asset:
type: string
example: btc
price:
type: string
example: '10377.8883'
volume:
type: string
example: '389.1346'
'400':
description: '400'
content:
application/json:
examples:
Result:
value: {}
schema:
type: object
properties: {}
deprecated: false
/spot/prices/assets/{asset}/historical/:
get:
summary: Assets Historical
description: >-
Retrieves the historical price for the specified asset - the price is
calculated across all exchanges which supports this asset, including all
cross rates pairs.
Price of an asset is calculated as the VWAP (Volume Weighted Average
Price) across all exchanges supporting this asset, with a 1 bar lookback
period.
operationId: spot-prices-assets-historical
parameters:
- name: asset
in: path
description: The asset for which to retrieve the requested data.
schema:
type: string
default: btc
required: true
- name: startDate
in: query
description: >-
**[Optional]** Payload only includes data after this date
(inclusive). <br>The interval can not exceed 12 months (d), 30 days
(h) or 24 hours (m).<br>**[Formats]** `seconds | milliseconds |
iso8601`<br>**[Examples]** `1578531600 | 1578531600000 |
2020-09-01T01:00:00`
schema:
type: string
format: date-time
- name: endDate
in: query
description: >-
**[Optional]** Payload only includes data before this date
(exclusive). <br>The interval can not exceed 12 months (d), 30 days
(h) or 24 hours (m).<br>**[Formats]** `seconds | milliseconds |
iso8601`<br>**[Examples]** `1578531600 | 1578531600000 |
2020-09-01T01:00:00`
schema:
type: string
format: date-time
- name: timeInterval
in: query
description: >-
**[Optional]** The time interval of the timeseries in the return
payload.<br/>**[Defaults]** `m* | minute | h | hour | d | day`
schema:
type: string
- name: timeFormat
in: query
description: >-
**[Optional]** Time format of the timestamps in the return
payload.<br/>**[Defaults]** `milliseconds | ms* | iso | iso8601 | hr
| human_readable`
schema:
type: string
responses:
'200':
description: '200'
content:
application/json:
schema:
type: object
properties:
status:
type: integer
example: 200
title:
type: string
example: OK
description:
type: string
example: Successful request
payload:
type: array
items:
type: object
properties:
timestamp:
type: string
format: date-time
example: '2020-09-11T20:17:00.000Z'
asset:
type: string
example: btc
price:
type: number
format: float
example: 10334.1579
volume:
type: number
format: float
example: 3.7839
examples:
Result:
value:
status: 200
title: OK
description: Successful request
payload:
- timestamp: '2020-09-11T20:17:00.000Z'
asset: btc
price: 10334.1579
volume: 3.7839
'400':
description: '400'
content:
application/json:
examples:
Result:
value: {}
schema:
type: object
properties: {}
deprecated: false
/spot/prices/pairs/information/:
get:
summary: Pairs Information
description: >-
Retrieves the list of all the available supported pairs and time range
availability.
operationId: spot-prices-pairs-information
parameters:
- name: pair
in: query
description: >-
**[Optional]** The pair for which to retrieve the
information.<br/>**[Default]** All available pairs.
schema:
type: string
default: btc_usd
- name: timeFormat
in: query
description: >-
**[Optional]** Time format of the timestamps in the return
payload.<br/>**[Defaults]** `milliseconds | ms* | iso | iso8601 | hr
| human_readable`
schema:
type: string
- name: includeInactive
in: query
description: >-
**[Optional]**If true, endpoint returns all pairs, including
delisted ones. <br/>**[Defaults]** `True| False*`
schema:
type: boolean
responses:
'200':
description: '200'
content:
application/json:
schema:
type: object
properties:
status:
type: integer
example: 200
title:
type: string
example: OK
description:
type: string
example: Successful request
payload:
type: object
properties:
metadata:
type: object
properties:
next:
type: string
format: uri
example: >-
https://api.amberdata.com/market/spot/prices/pairs/information?cursor=N4IgLglgtgpgYgewE5QIZhALhFCAbPCAZxgGMEA7AEyJABoQAzZNDbAKyMvpAAdUA5jCwBGBkQgAvYZhEAGBQF8gA
data:
type: array
items:
type: object
properties:
pair:
type: string
example: 00_usd
startDate:
type: number
format: int64
example: 1665446400000
endDate:
type: number
format: int64
example: 1677866100000
examples:
Result:
value:
status: 200
title: OK
description: Successful request
payload:
metadata:
next: >-
https://api.amberdata.com/market/spot/prices/pairs/information?cursor=N4IgLglgtgpgYgewE5QIZhALhFCAbPCAZxgGMEA7AEyJABoQAzZNDbAKyMvpAAdUA5jCwBGBkQgAvYZhEAGBQF8gA
data:
- pair: 00_usd
startDate: 1665446400000
endDate: 1677866100000
- pair: '123_456'
startDate: 1581206400000
endDate: 1632873600000
- pair: 18c_btc
startDate: 1556064000000
endDate: 1666915200000
'400':
description: '400'
content:
application/json:
examples:
Result:
value: {}
schema:
type: object
properties: {}
deprecated: false
/spot/prices/pairs/{pair}/latest/:
get:
summary: Pairs Latest
description: >-
Retrieves the latest price for the specified pair - the price is
calculated across all exchanges which supports this pair.
Price of a pair is calculated as the VWAP (Volume Weighted Average
Price) across all exchanges supporting this pair, with a 1 bar lookback
period.
If the parameter exchange is specified, the data returned is the price
for that pair on that exchange.
operationId: spot-prices-pairs-latest
parameters:
- name: pair
in: path
description: The pair for which to retrieve the mot r
# --- truncated at 32 KB (59 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/amberdata/refs/heads/main/openapi/amberdata-price-openapi.yaml