API Reference

Base URL: https://aarkdigital.org/api/v1/

All requests require Authorization: Bearer ark_live_YOUR_KEY.

GET /funding-rates

Returns the current (and optionally historical) funding rate for a given perpetual pair.

Parameters

Parameter	Type	Required	Description
pair	string	Yes	Perpetual pair. Example: BTC-PERP, ETH-PERP
window	string	No	Time window for rate. Default: 8h. Options: 1h, 8h, 24h
history	integer	No	Number of historical intervals to return. Max 90 (Trader plan). Explorer: max 7.

Response

{
  "pair": "BTC-PERP",
  "funding_rate": 0.000142,
  "interval": "8h",
  "annualized": 0.0619,
  "signal": "LONG_BIAS",
  "oracle_lag_ms": 118,
  "timestamp": "2026-05-29T14:32:01Z",
  "next_settlement": "2026-05-29T16:00:00Z"
}

GET /liquidation-map

Returns open interest density by price level for a given pair. Used to visualize liquidation cascade risk zones.

Parameters

Parameter	Type	Required	Description
pair	string	Yes	Perpetual pair
resolution	integer	No	Number of price buckets. Default: 20. Max: 100.
range_pct	float	No	Price range as % from mark price. Default: 5.0 (±5%). Min 1.0, max 20.0.

Response

{
  "pair": "BTC-PERP",
  "mark_price": 67842.00,
  "timestamp": "2026-05-29T14:32:01Z",
  "buckets": [
    {
      "price_low": 64449.90,
      "price_high": 65128.00,
      "oi_long_usd": 284000000,
      "oi_short_usd": 12000000,
      "cascade_risk": "HIGH"
    }
  ]
}

GET /mark-price

Returns the current mark price for a pair, including oracle source quality metrics and latency.

Parameters

Parameter	Type	Required	Description
pair	string	Yes	Perpetual pair

Response

{
  "pair": "BTC-PERP",
  "mark_price": 67842.00,
  "index_price": 67865.20,
  "deviation_pct": -0.034,
  "oracle_count": 4,
  "oracle_lag_ms": 118,
  "oracle_anomaly": false,
  "timestamp": "2026-05-29T14:32:01Z"
}

Error Codes

Code	Meaning
401	Invalid or missing API key
429	Rate limit exceeded
400	Invalid parameter value
404	Pair not found or not covered on your plan
503	Data feed temporarily unavailable