Perps - Token List
curl --request GET \
--url https://public-api.birdeye.so/perps/v1/token/list \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/perps/v1/token/list"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://public-api.birdeye.so/perps/v1/token/list', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"token": "BTC",
"long_io": 248130937.65533,
"short_io": 131704764.64346,
"open_interest": 379835702.29879,
"margin": 93565344.18447486,
"margin_used": 27115263.997527998,
"entry_margin": 27123192.271091487,
"unrealized_pnl": 205455.992125,
"bias": 1.2443300885242552,
"leverage": 14.0081875040353,
"bias_text": "Very Bullish"
}
]
}{
"success": false,
"message": "Bad request"
}{
"success": false,
"message": "Unauthorized"
}{
"success": false,
"message": "Access Denied"
}{
"success": false,
"message": "Too many requests"
}{
"success": false,
"message": "Internal Server Error"
}Perps Token
Perps Token List
GET
/
perps
/
v1
/
token
/
list
Perps - Token List
curl --request GET \
--url https://public-api.birdeye.so/perps/v1/token/list \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/perps/v1/token/list"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://public-api.birdeye.so/perps/v1/token/list', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"token": "BTC",
"long_io": 248130937.65533,
"short_io": 131704764.64346,
"open_interest": 379835702.29879,
"margin": 93565344.18447486,
"margin_used": 27115263.997527998,
"entry_margin": 27123192.271091487,
"unrealized_pnl": 205455.992125,
"bias": 1.2443300885242552,
"leverage": 14.0081875040353,
"bias_text": "Very Bullish"
}
]
}{
"success": false,
"message": "Bad request"
}{
"success": false,
"message": "Unauthorized"
}{
"success": false,
"message": "Access Denied"
}{
"success": false,
"message": "Too many requests"
}{
"success": false,
"message": "Internal Server Error"
}- Usage Note
- Accessibility
- Chain Supported
- Returns supported perpetual markets on Hyperliquid with ranking-style market metrics.
- Use list filters and sorting to narrow the market set before drilling into one token.
- This endpoint is market discovery for perp tokens, not a candle, trade, or wallet-position feed.
- Values are perp-market fields and should not be mixed directly with spot token analytics without normalization.
- Lite
- Starter
- Premium
- Business
- Enterprise
Hyperliquid
Compute Unit ⚙️
Compute Unit ⚙️
- This endpoint consumes
10 CUper request.
Use Cases 💡
Use Cases 💡
- Discover supported perp markets before loading deeper token-level analytics.
- Build ranked derivatives boards for open interest, directional bias, leverage, and participation.
- Feed market screeners that separate perp market structure from spot market activity.
- Find candidate markets for liquidation monitoring, position analysis, or trader tracking.
How to Use 🛠️
How to Use 🛠️
- Start here when you need the available Hyperliquid perp token universe.
- Apply supported sorting and filtering params to rank the markets you care about.
- Take the returned token identifier into
Perps Token Overview,Perps Token Open Positions, orPerps Token Liquidation Map.
Best Practices ✅
Best Practices ✅
- Use this endpoint as the first step in a perp workflow, then drill into one market with the token detail endpoints.
- Keep spot and perp dashboards separated unless you explicitly label and reconcile the metric definitions.
- Cache ranked lists briefly and refresh detail endpoints more aggressively for active monitoring flows.
Authorizations
API key for authentication
Headers
Specify the perpetuals exchange. Currently supports hyperliquid.
Available options:
hyperliquid Query Parameters
Available options:
4h, 1d, 7d, 30d, all Available options:
long_io, short_io, open_interest Specify the sort order.
Available options:
desc, asc Specify the offset for pagination. Filter for records with offset greater than the specified offset value, including those with offset equal to the specified offset.
Number of items per page.
Required range:
1 <= x <= 20Was this page helpful?

