Open Interest summary aggregates
GET/api/v1/open-interest/summary
Top-line aggregates over the current Open Interest snapshot — total OI USD, top tokens by OI, top exchanges by OI, and the count of venues currently reporting any base. Powers the OI page's KPI strip and breakdown card without forcing the caller to fetch the full token list.
Request
Query Parameters
Top N tokens to return
10Header Parameters
Your DataMaxi+ API key
Responses
- 200
- 400
OK
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
Array [
]
exchanges
object[]
sorted desc, all venues with data
Number of tokens this exchange has non-zero OI for.
tokens
object[]
top N by OI desc
Number of exchanges this token is listed on with non-zero OI. Useful for the breakdown card to show e.g. "BTC · 8 venues".
Token universe size — useful in the FE to label the KPI as "BTC of 1,234 tokens" instead of just "BTC".
{
"exchanges": [
{
"exchange": "string",
"openInterestUsd": 0,
"tokens": 0
}
],
"generatedAt": 0,
"grandTotal": 0,
"tokens": [
{
"base": "string",
"icon": "string",
"name": "string",
"openInterestUsd": 0,
"symbol": "string",
"tokenId": "string",
"venues": 0
}
],
"totalTokens": 0
}
Bad Request
- application/json
- Schema
- Example (from schema)
Schema
error specifies the error message
{
"error": "string"
}