ASasksurf
Exchange

Exchange Perpetual Contract Snapshot

Returns a perpetual futures snapshot for a trading pair: funding rate, open interest, mark/index price.

Available fields (via fields):

  • funding — current funding rate, next settlement, mark/index price
  • oi — open interest in contracts and USD

Just pass the base pair (e.g. pair=BTC/USDT). The swap settle suffix is added automatically from the quote currency, e.g. BTC/USDT:USDT or BTC/USDC:USDC.

get/gateway/v1/exchange/perp

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

pairstring required

Trading pair (e.g. BTC/USDT). The swap settle suffix is added automatically from the quote currency, e.g. BTC/USDT:USDT or BTC/USDC:USDC.

Example:BTC/USDT
fieldsstring

Comma-separated fields to include: 'funding' (current funding rate), 'oi' (open interest). Defaults to all fields.

Example:funding,oi
exchange'binance' | 'okx' | 'bybit' | 'bitget' | 'htx' | 'bitfinex' | 'bitmex' | 'hyperliquid'

Exchange identifier. Hyperliquid uses USDC-settled perps (e.g. BTC/USDC:USDC).

Example:binance

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataObjectResponseExchangePerpResponse.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.