History API

Base URL

https://pyth.dourolabs.app/v1

All {channel} path segments refer to a price channel (e.g. real_time, fixed_rate@200ms).

The /{channel}/... endpoints conform to the TradingView UDF specification, allowing you to connect TradingView charting UIs directly to this API.

Endpoints

Method	Path	Auth	Description
GET	`/live`	No	Health check
GET	`/symbols`	No	List available symbols
GET	`/{channel}/price`	Yes	Price at a specific timestamp
GET	`/{channel}/price/range`	Yes	Paginated prices over a time window
GET	`/{channel}/history`	Yes	OHLC candlestick data
GET	`/{channel}/search`	No	Search symbols
GET	`/{channel}/symbols`	No	Resolve a single symbol
GET	`/{channel}/config`	No	TradingView configuration
GET	`/publisher_updates`	Yes	Raw publisher updates

GET /symbols

List all available price feed symbols, optionally filtered.

Query Parameters

Parameter	Type	Required	Description
`query`	`string`	No	Text filter for symbol names
`asset_type`	`string`	No	Filter by asset type: `crypto`, `fx`, `equity`, `metal`, `rates`, `nav`, `commodity`, `funding-rate`

GET /{channel}/price

Returns price data at a specific historical timestamp.

Query Parameters

Parameter	Type	Required	Description	Example
`ids`	`number[]`	Yes	Price feed IDs	`1,2`
`timestamp`	`number`	Yes	Unix timestamp in microseconds	`1704067200000000`

GET /{channel}/price/range

Returns paginated price data for a set of feeds over a bounded time window.

Query Parameters

Parameter	Type	Required	Description	Example
`ids`	`number[]`	Yes	Price feed IDs (max 100)	`1,2`
`start_timestamp`	`number`	Yes	Window start, Unix timestamp in microseconds, inclusive	`1704067200000000`
`end_timestamp`	`number`	Yes	Window end, Unix timestamp in microseconds, inclusive; the window may not exceed 60 seconds	`1704067260000000`
`limit`	`number`	No	Max results per page, 1–1000 (default: `100`)	`500`
`after`	`string`	No	Opaque pagination cursor from a previous response's `next` field

Response Schema

Field	Type	Description
`data`	`object[]`	Price objects, one per feed and timestamp
`next`	`string`	Opaque cursor, present only when another page exists

Each data entry has the same shape as the GET /{channel}/price response: channel, channel_name, price_feed_id, price, publish_time, best_bid_price, best_ask_price, publisher_count, exponent, confidence, funding_rate, funding_timestamp, funding_rate_interval, market_session, ema_price, ema_confidence, feed_update_timestamp.

To fetch the next page, pass next verbatim as the after parameter of the following request; stop when next is absent. Cursors are opaque and must not be constructed by hand.

Errors

Status	Cause
`400`	Invalid parameters, window longer than 60 seconds, or feed not ready/unavailable on the channel
`401`	Missing bearer token
`403`	Token not entitled to a requested feed
`404`	Unknown feed ID

GET /{channel}/history

Returns OHLC candlestick data in TradingView format.

Query Parameters

Parameter	Type	Required	Description	Example
`symbol`	`string`	Yes	Trading pair symbol (case-insensitive)	`Crypto.BTC/USD`
`from`	`number`	Yes	Start timestamp (Unix seconds)	`1704067200`
`to`	`number`	Yes	End timestamp (Unix seconds)	`1704153600`
`resolution`	`string`	Yes	Candle resolution (see below)	`60`

Available Resolutions

Resolution	Description
`1`	1 minute
`2`	2 minutes
`5`	5 minutes
`15`	15 minutes
`30`	30 minutes
`60`	1 hour
`120`	2 hours
`240`	4 hours
`360`	6 hours
`720`	12 hours
`D`	1 day
`W`	1 week
`M`	1 month

Response Schema

Field	Type	Description
`s`	`string`	Status: `ok` or `error`
`t`	`number[]`	Unix timestamps (seconds)
`o`	`number[]`	Open prices
`h`	`number[]`	High prices
`l`	`number[]`	Low prices
`c`	`number[]`	Close prices
`v`	`number[]`	Volumes (if available)

Arrays are aligned by index — t[0], o[0], h[0], l[0], c[0] represent the same candle.

GET /{channel}/search

Search for symbols by name and type.

Query Parameters

Parameter	Type	Required	Description
`query`	`string`	Yes	Search text
`type`	`string`	Yes	Asset type filter
`exchange`	`string`	Yes	Exchange name (default: `"PYTH"`)
`limit`	`number`	Yes	Max results (default: `15`)

GET /{channel}/symbols

Resolve a single symbol to its full configuration.

Query Parameters

Parameter	Type	Required	Description
`symbol`	`string`	Yes	Symbol name (case-insensitive)

GET /{channel}/config

Returns TradingView-compatible configuration including supported resolutions and data capabilities.

GET /publisher_updates

Returns raw publisher price updates. Requires authentication.

Query Parameters

Parameter	Type	Required	Description
`price_feed_id`	`number[]`	No	Filter by price feed IDs
`min_timestamp`	`string`	No	ISO 8601 start time (default: 7 days ago)
`max_timestamp`	`string`	No	ISO 8601 end time
`sort`	`string`	Yes	`"Ascending"` or `"Descending"`
`limit`	`number`	No	Max results, 1–10000 (default: `15`)

Authentication

GET /{channel}/price, GET /{channel}/price/range, and GET /{channel}/history require API-key authentication. Pass your Pro API key as a bearer token:

curl -H "Authorization: Bearer $PRO_API_KEY" \
  "https://pyth.dourolabs.app/v1/fixed_rate@200ms/price?ids=1&timestamp=1704067200000000"

Do not embed your Pro API key in frontend or browser applications. The key must stay server-side. Route requests through your own backend, which injects the Authorization header before forwarding to this API.

For browser/frontend apps that cannot hold a secret, see Frontend Authentication.

See Acquire an API Key to obtain a key.

OpenAPI Schema

The full OpenAPI specification is available at:

Examples Repository
Price Feed IDs - Symbol to ID mapping

On this page