Market Data
Perpetual Ticker
Query the current funding-bearing perpetual ticker alias.
GET
Perpetual Ticker
This route currently returns the same funding-bearing ticker observations as
/funding-rates, with the same filters, pagination, access rules, and partial fields. It does not provide every independent perpetual price or open-interest update.
Request
Query parameters
Access and behavior
With no bounds, the API queries the latest hour anonymously. Explicit bounds inside the rolling last hour are also public; older history requires a Polaris API key.start and end are inclusive collector timestamps in Unix milliseconds. With only start, the query runs through now; with only end, it covers the preceding hour, clamped to the anonymous cutoff. Anonymous reads are capped at 1 GiB per request and two concurrent queries per API replica. Rows that age out of the public hour are skipped during anonymous pagination.
Response
items[] fields
Mark price, index price, and open interest appear only when published in the same funding-bearing observation.
SDK perpetual tickers
Pythonclient.perpetual_tickers(...), TypeScript client.perpetualTickers(...), and Rust client.perpetual_tickers(HistoricalQuery) return partial perpetual_ticker events. Their payload can include last, mark, index, oracle, and midpoint prices, open interest, premium, and current or predicted funding values. A missing field was not published in that observation; do not interpret it as zero. The SDK event stream is wider than this REST alias, and SDK to is exclusive while REST end is inclusive. See SDK perpetual ticker fields for legacy/v2 envelopes and examples.
Pagination
Passnext_cursor as cursor with the same filters. Stop when has_more is false, or when next_cursor is null for endpoints without has_more. A cursor is opaque; do not edit or reuse it with different filters.
Errors
The OpenAPI contract lists400, 401, 422, 429, 503. Error responses use error.code, error.message, and error.resolution. Narrow an expensive query after 422. Follow Retry-After after 429.
For the machine-readable contract, see the OpenAPI document.