Perpetual Contract Snapshot

GET /gateway/v1/exchange/perp

Exchange Perpetual Contract Snapshot

cURL

curl --request GET \
  --url https://api.asksurf.ai/gateway/v1/exchange/perp

200

{
  "data": {
    "exchange": "<string>",
    "funding": {
      "exchange": "<string>",
      "funding_rate": 123,
      "index_price": 123,
      "interval": "<string>",
      "mark_price": 123,
      "next_funding": "<string>",
      "pair": "<string>"
    },
    "open_interest": {
      "exchange": "<string>",
      "open_interest_amount": 123,
      "open_interest_usd": 123,
      "pair": "<string>",
      "timestamp": 123
    },
    "pair": "<string>"
  },
  "meta": {
    "cached": true,
    "credits_used": 123
  },
  "$schema": "https://example.com/schemas/DataObjectResponseExchangePerpResponse.json"
}

Query Parameters

pair · string · required

Trading pair (e.g. BTC/USDT). The swap suffix ':USDT' is added automatically.

Example:

"BTC/USDT"

fields · string · default: funding,oi

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

Example:

"funding,oi"

exchange · enum<string> · default: binance

Exchange identifier

Available options: binance, okx, bybit, bitget, htx, bitfinex, bitmex

Example:

"binance"

Response

200

application/json

OK

data · object · required

Show child attributes

meta · object · required

Show child attributes

$schema · string<uri> · read-only

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/DataObjectResponseExchangePerpResponse.json"