API v1
Read-only REST API. Base https://basis.hedgen.xyz/api/v1. JSON responses { data, meta }. Data for informational purposes only, not advice.
AUTHENTICATION & QUOTAS
- Public (no key) —
/snapshotand/unlocks: 60 req/h/IP. - Pro (key) — header
Authorization: Bearer bsk_live_…: 5,000 req/day/key, all endpoints. Create your key on /keys.
ENDPOINTS
| Endpoint | Access | Parameters | Description |
|---|---|---|---|
| GET /api/v1/snapshot | free | — | Latest snapshot: peg, supply, sUSDe APY, reserve, composite funding + per venue, regime. |
| GET /api/v1/unlocks | free | — | ENA unlock schedule (sourced config). |
| GET /api/v1/funding | PRO | asset, venue, from, to, granularity=raw|daily | Funding series (raw ≤ 90d, daily beyond). |
| GET /api/v1/protocol/history | PRO | metrics, from, to | Protocol snapshot series (metrics of your choice). |
| GET /api/v1/defi/history | PRO | venue, from, to | DeFi position series (Aave, Pendle). |
EXAMPLES
Public snapshot:
curl https://basis.hedgen.xyz/api/v1/snapshotFunding series (Pro, key):
curl -H "Authorization: Bearer bsk_live_…" \
"https://basis.hedgen.xyz/api/v1/funding?asset=BTC&venue=binance&from=2026-06-01&to=2026-07-01"Protocol history (metrics of your choice):
curl -H "Authorization: Bearer bsk_live_…" \
"https://basis.hedgen.xyz/api/v1/protocol/history?metrics=usde_supply_usd,susde_apy&from=2026-06-01"RESPONSES & ERRORS
Success envelope:
{
"data": [ /* … */ ],
"meta": { "as_of": "2026-07-13T09:00:00.000Z", "count": 720 }
}Error:
{ "error": { "code": "rate_limited", "message": "…" } }Codes: unauthorized (401) · rate_limited (429, + Retry-After header) · invalid_params (400) · unavailable (503). Pagination by from/to window only, max 10,000 points/req.