Get API key
Corporate actions

Overview

API version2026-09-29

Reference data for the assets behind Pyth Price Feeds: what each feed prices, the asset's identifiers, and its corporate actions, such as dividends, splits, ticker changes and delistings.

Every request sends an API key and the API version. In a browser, use an access token from POST /auth/token instead of the key.

getv3/intelligence/feeds/{id}
curl "https://pyth.dourolabs.app/v3/intelligence/feeds/922" \
  -H "Authorization: Bearer $PYTH_API_KEY" \
  -H "Pyth-Version: 2026-09-29"

Versions

Pin the API version

Send Pyth-Version: 2026-09-29 with every request. Without it, a request gets the newest version, so the shape of its response can change when a new version is released.

Each version is a date. A change that can break a client ships under a new date. Endpoints, optional parameters, response fields and enum values can be added without one. Treat an unrecognized enum value as unknown.

get/feeds/922

A request without a Pyth-Version header gets the newest version, 2026-09-29 today. After a newer version is released, the same request gets the newer shape.

Errors

Every error from the data endpoints has the shape {"error": {"category", "code", "message"}}. Branch on code, because messages can change.

400 · /feeds/922?bogus=1
{
  "error": {
    "category": "invalid_request",
    "code": "parameter_invalid",
    "message": "`bogus` is not a parameter here; the parameters are effective, expand"
  }
}