get
https://public-api.birdeye.so/perps/v1/wallet/open_positions
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
- Returns all currently open perp positions for one wallet.
sizeis signed and should be interpreted together withleverage_type,entry_price,mark_price, andliquidation_price.- Cross and isolated positions can coexist in the same response depending on the trader's book.
- Data availability begins on May 25, 2026 at 15:00 UTC.
- Lite
- Starter
- Premium
- Business
- Enterprise
Hyperliquid
Use Cases 💡
- Inspect a trader's live perp book token by token.
- Build copy-trading research views and trader-monitoring dashboards.
- Check where a trader is concentrated, levered, and closest to liquidation.
- Monitor how a wallet rotates between markets over time.
How to Use 🛠️
- Set
x-perpand pass the wallet address inwallet. - Use
token,size,position_value,margin_used, andunrealized_pnlas the core exposure fields. - Read
liquidation_pricewhen available to gauge liquidation distance.
Best Practices ✅
- Join this endpoint with wallet overview so you can relate book-level rows to total equity and total leverage.
- Track repeated snapshots if you want to infer position changes over time; this endpoint is a current-state view.
- Separate long and short exposure explicitly when aggregating signed
size.
Limitations ⚠️
- Hyperliquid only.