metaAndAssetCtxs

This endpoint is currently mainnet-only.

Returns perpetual market metadata together with the per-asset trading context (prices, open interest, and 24h volume) in a single request.

Field	Type	Description
type	string	Must be "metaAndAssetCtxs"
dex	string	Perp DEX name (optional). Defaults to empty string for the first perp DEX; pass a builder-deployed DEX name for a HIP-3 market.

Request

cURL

curl -X POST https://api.hydromancer.xyz/info \
  -H "Authorization: Bearer $HYDROMANCER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept-Encoding: gzip" \
  -d '{
    "type": "metaAndAssetCtxs"
  }'

Python

import requests
import os
import json

response = requests.post(
    'https://api.hydromancer.xyz/info',
    json={
        'type': 'metaAndAssetCtxs'
    },
    headers={
        'Authorization': f'Bearer {os.environ["HYDROMANCER_API_KEY"]}',
        'Content-Type': 'application/json'
    }
)
print(json.dumps(response.json(), indent=2))

Javascript

import axios from 'axios';

const response = await axios.post(
  'https://api.hydromancer.xyz/info',
  {
    type: 'metaAndAssetCtxs'
  },
  {
    headers: {
      'Authorization': `Bearer ${process.env.HYDROMANCER_API_KEY}`,
      'Content-Type': 'application/json'
    }
  }
);

console.log(JSON.stringify(response.data, null, 2));

The response can be large (~50 KB for the full native universe). Send Accept-Encoding: gzip (or br) to receive it compressed.

---

Response Fields

The response is a two-element array: [meta, assetCtxs].

meta is identical to the meta endpoint (universe, marginTables, collateralToken).

assetCtxs is an array of per-asset context objects in the same order as meta.universe, so assetCtxs[i] corresponds to meta.universe[i]. An asset with no cached context is returned with null fields, keeping the array aligned with the universe.

Field	Type	Description
oraclePx	string	Oracle price
markPx	string	Mark price
midPx	string	Mid price; null when there is no book
impactPxs	array	[impact bid, impact ask]; null when unavailable
openInterest	string	Open interest, in base units
dayNtlVlm	string	24-hour notional volume (sum of price × size over the trailing 24 hours)
dayBaseVlm	string	24-hour base volume (sum of size over the trailing 24 hours)

Response

[
  {
    "universe": [
      {
        "name": "BTC",
        "szDecimals": 5,
        "maxLeverage": 40,
        "onlyIsolated": false
      }
    ],
    "marginTables": [],
    "collateralToken": 0
  },
  [
    {
      "oraclePx": "63961",
      "markPx": "63970",
      "midPx": "63965.5",
      "impactPxs": ["63960", "63971"],
      "openInterest": "37318.54584",
      "dayNtlVlm": "1690219500.99709",
      "dayBaseVlm": "26703.40439"
    }
  ]
]