{"slug":"api-hivemindos-app-v1-x402-onchain-intelligence-perps-brief-d1d1f0","title":"Perp positions and trades","host":"api.hivemindos.app","method":"POST","resource":"https://api.hivemindos.app/v1/x402/onchain-intelligence/perps.brief","category":"market","description":"Perp positions and trades: Hyperliquid perp positions and trades for a wallet or a perp token, or the busiest perp markets. Use when an agent needs Hyperliquid positions and trades for a wallet, or the busiest perp markets. $0.05 this call, in USDC on Base; you pay only if it succeeds. HivemindOS Su","price_listed":0.05,"price_asked":0.05,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":295,"reported_calls_30d":3,"reported_payers_30d":2,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"tokenSymbol":"BTC"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"properties":{"address":{"description":"EVM wallet address (0x…).","pattern":"^0x[0-9a-fA-F]{40}$","type":"string"},"date":{"description":"The window to read, as YYYY-MM-DD dates. Defaults to recent days.","properties":{"from":{"format":"date","type":"string"},"to":{"format":"date","type":"string"}},"required":["from","to"],"type":"object"},"request":{"description":"The read in plain words, naming the address, $SYMBOL, chain or exchange.","maxLength":2000,"type":"string"},"tokenSymbol":{"description":"A perp market symbol, such as BTC.","maxLength":20,"type":"string"}},"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"properties":{"chargedCredits":{"description":"Agent Credits the service charged (500 = $1).","type":"number"},"followUp":{"description":"apiKey holding the credits the call did not use, or null when none are left.","properties":{"apiKey":{"type":"string"},"keyId":{"type":["string","null"]},"remainingCredits":{"type":"number"},"use":{"type":"string"}},"type":["object","null"]},"ok":{"description":"true when the call worked; a failed call is never charged.","type":"boolean"},"operationId":{"type":"string"},"result":{"description":"Open perp positions and recent trades for the wallet or token, or the busiest perp markets."},"serviceId":{"type":"string"},"status":{"description":"The service's own HTTP status.","type":"integer"},"x402":{"description":"The payment: settled only after the call worked.","properties":{"charged":{"type":"boolean"},"network":{"type":["string","null"]},"payer":{"type":["string","null"]},"priceUsd":{"type":"number"},"receiptId":{"type":"string"},"transaction":{"type":["string","null"]}},"type":"object"}},"required":["ok","x402"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.05,"price_match":true,"latency_ms":295,"error":null}],"description_full":"Perp positions and trades: Hyperliquid perp positions and trades for a wallet or a perp token, or the busiest perp markets. Use when an agent needs Hyperliquid positions and trades for a wallet, or the busiest perp markets. $0.05 this call, in USDC on Base; you pay only if it succeeds. HivemindOS SuperAgent API.","last_updated":"2026-10-23T12:01:12.171Z","schemes":["exact"]}