get
https://public-api.birdeye.so/perps/v1/token/list
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
- Ranked perp-market list across the selected exchange, with open interest, margin usage, leverage, and bias metrics.
biasis directional: positive means the book leans long, negative means it leans short.time_frameandsort_bycontrol the ranking context, so the same market can move materially depending on the view.- Data availability begins on May 25, 2026 at 15:00 UTC.
- Lite
- Starter
- Premium
- Business
- Enterprise
Hyperliquid
Use Cases 💡
- Rank perp markets by open interest, leverage, margin deployment, or positioning skew.
- Build perp screeners that surface crowded longs, crowded shorts, or leverage-heavy markets.
- Monitor how directional conviction rotates across major markets over time.
- Feed internal dashboards for market structure, risk clustering, and venue-level perp analytics.
How to Use 🛠️
- Set
x-perpto the supported venue. - Choose
time_frameandsort_bybased on whether you care about current structure or recent activity. - Use
offsetandlimitfor pagination when scanning the full market set. - Read
biasandbias_texttogether withopen_interestandleverageto avoid overfitting to one metric.
Best Practices ✅
- Start with a broad sort like open interest, then drill into leverage and unrealized PnL for risk context.
- Compare long and short open interest, not just the combined total, before labeling a market crowded.
- Pair this endpoint with token overview and liquidation map to connect positioning with liquidation risk.
Limitations ⚠️
- Hyperliquid only.