Perps - Wallet Open Positions
curl --request GET \
--url https://public-api.birdeye.so/perps/v1/wallet/open_positions \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/perps/v1/wallet/open_positions"
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/wallet/open_positions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"token": "BTC",
"leverage_type": "cross",
"leverage_value": 10,
"max_leverage": 40,
"entry_price": 77241.5,
"mark_price": 80787,
"liquidation_price": null,
"margin_used": 771179.64816,
"position_value": 7710078.6134399995,
"roe": 0.4590149077892066,
"size": 95.43712,
"unrealized_pnl": 338372.30896,
"cum_funding_since_open": 28605.300979,
"cum_funding_since_change": 398.514496,
"open_time": 1770775214
}
]
}{
"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 Wallet
Perps Wallet Open Positions
GET
/
perps
/
v1
/
wallet
/
open_positions
Perps - Wallet Open Positions
curl --request GET \
--url https://public-api.birdeye.so/perps/v1/wallet/open_positions \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/perps/v1/wallet/open_positions"
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/wallet/open_positions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"token": "BTC",
"leverage_type": "cross",
"leverage_value": 10,
"max_leverage": 40,
"entry_price": 77241.5,
"mark_price": 80787,
"liquidation_price": null,
"margin_used": 771179.64816,
"position_value": 7710078.6134399995,
"roe": 0.4590149077892066,
"size": 95.43712,
"unrealized_pnl": 338372.30896,
"cum_funding_since_open": 28605.300979,
"cum_funding_since_change": 398.514496,
"open_time": 1770775214
}
]
}{
"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 the currently open perpetual positions for one Hyperliquid wallet.
- Position rows are live inventory entries, not historical executions.
- Use this endpoint to inspect token-by-token exposure, leverage, liquidation price, size, margin, and unrealized performance.
- This endpoint is wallet-centric; use token-centric position data when the market is your starting point instead of the trader.
- Lite
- Starter
- Premium
- Business
- Enterprise
Hyperliquid
Compute Unit ⚙️
Compute Unit ⚙️
- This endpoint consumes
5 CUper request.
Use Cases 💡
Use Cases 💡
- Inspect a trader’s live perp book token by token.
- Build wallet risk dashboards showing leverage, liquidation sensitivity, and exposure concentration.
- Analyze whether a trader is net long, net short, diversified, or highly concentrated.
- Support trader due diligence, copy-trading research, and risk monitoring workflows.
How to Use 🛠️
How to Use 🛠️
- Pass one Hyperliquid wallet address.
- Read each row as one active perp position held by that wallet.
- Combine with
Perps Wallet Overviewfor summary context andPerps Token Overviewfor market-side context.
Best Practices ✅
Best Practices ✅
- Use wallet overview first when you only need a quick trader snapshot.
- Diff consecutive snapshots if you want to detect position changes, scaling, or rotation.
- Cross-check liquidation prices against token-side liquidation-map context for better risk interpretation.
Authorizations
API key for authentication
Headers
Specify the perpetuals exchange. Currently supports hyperliquid.
Available options:
hyperliquid Query Parameters
The address of the wallet.
Was this page helpful?

