StatusTerminal
APIUse casesOracleMCP & AgentsSDKsSkillsChangelog

Latest prices

GET
/v2/updates/price/latest

The current value of each requested feed, whatever the channel. A feed with no servable value yet counts as not found.

Send at most 200 IDs per request; longer URLs are rejected before they reach Astra. For more feeds, use several requests or subscribe over WebSocket, where IDs travel in the message body.

Query Parameters

ids[]*array<>

Feed IDs, repeated (ids[]=…&ids[]=…). ids is accepted too. The server accepts at most 500 per request, and 100 distinct feeds on historical routes. Send at most 200 IDs per request; longer URLs are rejected before they reach Astra. For more feeds, use several requests or subscribe over WebSocket, where IDs travel in the message body.

Itemsitems <= 500
ids?array<>

The same as ids[], for clients that send the name without brackets. Both may be combined, and count together. Send at most 200 IDs per request; longer URLs are rejected before they reach Astra. For more feeds, use several requests or subscribe over WebSocket, where IDs travel in the message body.

encoding?string

Encoding named in binary.encoding on the v2 routes. The data array is always empty. Validated and ignored on the v1 routes.

Default"hex"

Value in

  • "hex"
  • "base64"
parsed?boolean

Include the parsed prices on the v2 routes. Validated and ignored on the v1 routes.

Defaulttrue
ignore_invalid_price_ids?boolean

Drop unknown IDs instead of answering 404, on the v2 routes. Validated and ignored on the v1 routes.

Defaultfalse
channel?string

Update cadence of the SSE stream and the WebSocket. A fixed-rate channel sends a feed at most once per tick, only when it changed. fixed_rate@50ms is refused. Validated and ignored on the other routes.

Default"fixed_rate@1000ms"

Value in

  • "real_time"
  • "fixed_rate@200ms"
  • "fixed_rate@1000ms"
benchmarks_only?boolean

On the SSE stream, send only the first update of each second. Validated and ignored elsewhere.

Defaultfalse
verbose?boolean

Include metadata, on the v1 routes. Validated and ignored on the v2 routes.

Defaultfalse
binary?boolean

Include vaa, which is always the empty string, on the v1 routes. Validated and ignored on the v2 routes.

Defaultfalse
unique?boolean

On the interval route, keep only the first update of each feed in each second. Validated and ignored elsewhere.

Defaulttrue
allow_unordered?boolean

Accepted for Hermes compatibility. Updates are always ordered, so it changes nothing.

Defaultfalse

Response Body

application/json

text/plain

text/plain

text/plain

curl -X GET "https://example.com/v2/updates/price/latest?ids%5B%5D=string"
{  "binary": {    "encoding": "hex",    "data": []  },  "parsed": [    {      "id": "string",      "price": {        "price": "string",        "conf": "string",        "expo": 0,        "publish_time": 0      },      "ema_price": {        "price": "string",        "conf": "string",        "expo": 0,        "publish_time": 0      },      "metadata": {        "slot": 0,        "proof_available_time": 0,        "prev_publish_time": 0      }    }  ]}

Get one price feed GET

The feed's metadata. The response echoes the ID you asked with, Pyth-compatible or Astra.

Stream prices (SSE) GET

Server-sent events. Each event carries one `PriceUpdate` for one feed as `data: {json}`. The last value of each feed is sent on connect. A `: keepalive` comment arrives every 30 seconds, and the stream closes after 24 hours: reconnect. Per feed, updates arrive in `publish_time` order and never repeat. Send at most 200 IDs per request; longer URLs are rejected before they reach Astra. For more feeds, open several streams or subscribe over WebSocket, where IDs travel in the message body.