API v1

API REST en lecture seule. Base https://basis.hedgen.xyz/api/v1. Réponses JSON { data, meta }. Données à titre informatif uniquement, pas un conseil.

AUTHENTIFICATION & QUOTAS

Public (sans clé) — /snapshot et /unlocks : 60 req/h/IP.
Pro (clé) — en-tête Authorization: Bearer bsk_live_… : 5 000 req/jour/clé, tous endpoints. Crée ta clé sur /keys.

ENDPOINTS

Endpoint	Accès	Paramètres	Description
GET /api/v1/snapshot	libre	—	Dernier snapshot : peg, supply, sUSDe APY, reserve, funding composite + par venue, régime.
GET /api/v1/unlocks	libre	—	Calendrier des unlocks ENA (config sourcé).
GET /api/v1/funding	PRO	asset, venue, from, to, granularity=raw\|daily	Séries funding (raw ≤ 90 j, daily au-delà).
GET /api/v1/protocol/history	PRO	metrics, from, to	Séries des snapshots protocole (métriques au choix).
GET /api/v1/defi/history	PRO	venue, from, to	Séries des positions DeFi (Aave, Pendle).

EXEMPLES

Snapshot public :

curl https://basis.hedgen.xyz/api/v1/snapshot

Séries funding (Pro, clé) :

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"

Historique protocole (métriques au choix) :

curl -H "Authorization: Bearer bsk_live_…" \
  "https://basis.hedgen.xyz/api/v1/protocol/history?metrics=usde_supply_usd,susde_apy&from=2026-06-01"

RÉPONSES & ERREURS

Enveloppe de succès :

{
  "data": [ /* … */ ],
  "meta": { "as_of": "2026-07-13T09:00:00.000Z", "count": 720 }
}

Erreur :

{ "error": { "code": "rate_limited", "message": "…" } }

Codes : unauthorized (401) · rate_limited (429, + en-tête Retry-After) · invalid_params (400) · unavailable (503). Pagination par fenêtre from/to uniquement, max 10 000 points/req.