List Historical Prices

curl --request GET \
  --url https://api.paxos.com/v2/markets/{market}/historical-prices \
  --header 'Authorization: Bearer <token>'

{
  "market": "BTCUSD",
  "prices": [
    {
      "average_price": "9245.50",
      "timestamp": "2020-01-17T18:36:00.000Z"
    },
    {
      "average_price": "9265.50",
      "timestamp": "2020-01-17T18:37:00.000Z"
    }
  ],
  "total_count": 50
}

Pricing

List Historical Prices

Retrieves a set of average prices at a certain increment of time for the requested market. This endpoint is suitable for retrieving historical average price trends where price precision, execution, and other detailed information is not required. To control the count, use either increment or max_data_points. List Historical Prices returns an error when an unexpected value is given, or when increment and max_data_points are both given or omitted.

When range.begin is omitted, the first data point shows the mid price, the average of the order book best bid and ask price, or the earliest available date. It is possible to set range.begin to a future date without error.

When range.end is omitted, the last data point will display current mid price (average of order book best bid and best ask) at the request timestamp. It is possible to set range.end to a future date without error.

When pagination.limit is omitted, the pagination limit will default to return the first 100 items. If the pagination limit is set, the API will return up to the limit in one response. The pagination limit max is 1,000.

Time-series items are returned in chronological (ascending) order. All timestamps are in UTC.

GET

markets

{market}

historical-prices

List Historical Prices

curl --request GET \
  --url https://api.paxos.com/v2/markets/{market}/historical-prices \
  --header 'Authorization: Bearer <token>'

{
  "market": "BTCUSD",
  "prices": [
    {
      "average_price": "9245.50",
      "timestamp": "2020-01-17T18:36:00.000Z"
    },
    {
      "average_price": "9265.50",
      "timestamp": "2020-01-17T18:37:00.000Z"
    }
  ],
  "total_count": 50
}

OAuth Scope

exchange:historical_prices

Authorizations

Authorization

string

header

required

Paxos APIs use OAuth 2 with the client credentials grant flow.

Token URLs:

Production: https://oauth.paxos.com/oauth2/token
Sandbox: https://oauth.sandbox.paxos.com/oauth2/token

Learn more in the API credentials guide →

Path Parameters

market

enum<string>

required

Market of Order Book.

Available options:

ETHEUR,

ETHUSD,

BTCEUR,

BTCUSD,

PAXGUSD,

BCHUSD,

LTCUSD,

ETHGBP,

BTCGBP,

LTCGBP,

BCHGBP,

USDPUSD,

ETHBRL,

BTCBRL,

LTCBRL,

BCHBRL,

USDPGBP,

USDPBRL,

LINKUSD,

MATICUSD,

AAVEUSD,

UNIUSD,

AAVEMXN,

BCHMXN,

BTCMXN,

ETHMXN,

LTCMXN,

USDPMXN,

AAVEEUR,

BCHEUR,

LTCEUR,

LINKEUR,

MATICEUR,

PAXGEUR,

SOLEUR,

USDPEUR,

UNIEUR,

PYUSDEUR,

PYUSDGBP

Query Parameters

max_data_points

integer

Maximum number of data points to return.

The time frame of the increments will be inferred by finding the most granular increment without breaching the max_data_points value based on a set of recording data points.

range.begin

string<date-time>

Only return records after this timestamp, inclusive. RFC3339 format, like 2006-01-02T15:04:05Z.

range.end

string<date-time>

Only return records before this timestamp, inclusive. RFC3339 format, like 2006-01-02T15:04:05Z.

pagination.limit

integer

Number of results to return

pagination.offset

integer

Number of results to skip

increment

enum<string>

Time increment between prices. Returns data exclusive from range.begin and range.end. Do not use with max_data_points, as this results in an error.

Available options:

ONE_MINUTE,

FIVE_MINUTES,

FIFTEEN_MINUTES,

THIRTY_MINUTES,

ONE_HOUR,

TWO_HOURS,

TWELVE_HOURS,

ONE_DAY,

ONE_WEEK,

TWO_WEEKS,

FOUR_WEEKS

Response

200 - application/json

A successful response.

total_count

integer

items

object[]

List of historical prices.

Show child attributes

List Tickers Overview

API Documentation

Deposits and Withdrawals

Identity

Profiles

Sandbox

Settlements

Stablecoin Conversion

Taxes

Trading

Rewards

Events

API Credentials

Websockets

Webhooks

Problems

List Historical Prices

Authorizations

Path Parameters

Query Parameters

Response