get
https://public-api.birdeye.so/perps/v1/token/overview
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
- Returns a compact perp-market snapshot for one token, centered on price, position count, open interest, and liquidation totals.
- Liquidation fields are already grouped by lookback window:
1h,4h,1d, and7d. - This endpoint is ideal when you need one market summary, not the full ranked market list.
- Data availability begins on May 25, 2026 at 15:00 UTC.
- Lite
- Starter
- Premium
- Business
- Enterprise
Hyperliquid
Use Cases 💡
- Show a single-market perp summary on token pages and market monitors.
- Compare current open interest against recent liquidation pressure before sizing risk.
- Add perp context to spot-token dashboards without loading full market rankings.
- Feed alerting systems that watch for sudden liquidation build-up around a token.
How to Use 🛠️
- Set
x-perpto Hyperliquid and pass the market symbol intoken. - Read
price,position_count, andopen_interestfirst for the current state. - Use the liquidation windows to compare short-term stress against multi-day liquidation accumulation.
Best Practices ✅
- Use this endpoint for per-market cards and single-market overlays; use token list for ranking workflows.
- Compare
1hagainst1dand7dbefore treating a liquidation spike as structurally important. - Pair with open positions and liquidation map when you need both summary and depth.
Limitations ⚠️
- Hyperliquid only.