Back to Browse
x402stock Perpetuals Account Lookup
x402
x402stock Perpetuals Account Lookup is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-08).
Returns the full on-chain perpetuals account snapshot for a given wallet address on Hyperliquid, including positions, margin, PnL, and open orders
Price / call$0.02
Success—
StatusUnknown
How this service works
Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.
Output
A JSON snapshot of the wallet's perpetuals account on Hyperliquid, including: account value, withdrawable balance, total margin used, maintenance margin, total notional position, an array of open positions (coin, side, size, leverage, entry price, position value, unrealized PnL, ROE, liquidation price, margin used, max leverage, funding since open), and an array of open orders (coin, side, size, order ID, timestamp, limit price).
Example use cases
Check liquidation risk on positions
“I'm worried about getting liquidated — can you pull the full account snapshot for my Hyperliquid perps wallet 0x4a7b2c9d1e3f5a8b6c0d2e4f7a1b3c5d and tell me how close I am to liquidation on each position, what my maintenance margin looks like, and whether I have enough withdrawable balance to add more margin if needed?”
Monitor leverage and funding costs
“For my on-chain perps wallet 0x8d3f1a2b4c6e9f0a7b5c3d1e2f4a6b8c, pull up the latest account snapshot and break down the leverage I'm using on each position, what funding payments I've accumulated since open, and flag any positions where my margin usage seems dangerously high.”
Review open orders before market open
“Before trading kicks off, grab the full Hyperliquid perpetuals snapshot for wallet 0x2e5f7a9b1c3d4e6f8a0b2c4d6e8f0a1b and show me all my open limit orders alongside my current positions — I want to make sure my orders are still priced sensibly relative to my entry prices and unrealized PnL.”
Technical details
Endpoint
GEThttps://x402stock.xyz/api/v1/perps/account/%7Baddress%7DWhen to prefer
Use this endpoint when you need a real-time snapshot of a specific wallet's on-chain perpetuals account on Hyperliquid — including positions, margin, PnL, and open orders — without needing an API key or account. Prefer this over exchange-specific APIs when you want pay-per-call pricing in USDC and no authentication overhead.
Side effects
- Invalid or malformed wallet address returns an error or empty positions array
- Address with no perps activity returns empty positions and orders arrays
- Hyperliquid data source temporarily unavailable causing upstream timeout
- limit parameter out of range (>1000 or <0) returns validation error
- Missing address path parameter causes 404 or 400 response
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| output | object |
Output
Schema · Response
{
"type": "json",
"example": {
"as_of": "2026-06-06T00:00:00.000Z",
"venue": "hyperliquid",
"market": "perp",
"source": "x402stock",
"address": "0x31ca8395cf837de08b24da3f660e77761dfb974b",
"positions": [
{
"coin": "BTC",
"side": "short",
"size": -0.59864,
"leverage": 20,
"entry_price": 61691.7,
"margin_used": 1851.62,
"max_leverage": 50,
"leverage_type": "cross",
"position_value": 37032.47,
"unrealized_pnl": -101.3,
"return_on_equity": -0.0548573051,
"liquidation_price": 5078920.58,
"funding_since_open": -54.32
}
],
"open_orders": [
{
"coin": "WLD",
"side": "buy",
"size": 555,
"order_id": 461295382727,
"orig_size": 555,
"timestamp": "2026-06-06T00:00:00.000Z",
"limit_price": 0.45186
}
],
"withdrawable": 2739294.87,
"account_value": 3066130.2,
"total_raw_usd": 2840711.89,
"open_orders_count": 1,
"total_margin_used": 163417.67,
"maintenance_margin_used": 32683.53,
"total_notional_position": 3268353.3
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"