{"slug":"api-nansen-ai-api-v1-profiler-perp-positions-5a43c0","title":"Get Perpetual Positions Data","host":"api.nansen.ai","method":"POST","resource":"https://api.nansen.ai/api/v1/profiler/perp-positions","category":"other","description":"Get Perpetual Positions Data","price_listed":0.01,"price_asked":0.01,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":219,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:143","eip155:196","eip155:56","eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"address":"0xa312114b5795dff9b8db50474dd57701aa78ad1e","filters":{"position_value_usd":{"min":1000},"unrealized_pnl_usd":{"max":0}},"order_by":[{"direction":"DESC","field":"position_value_usd"}]},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"address":{"type":"string"},"filters":{"type":"object"},"order_by":{"type":"array"}},"required":["address"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"properties":{"assetPositions":{"items":{"type":"object"},"type":"array"},"crossMaintenanceMarginUsed":{"type":"string"},"cross_margin_summary_account_value_usd":{"type":"string"},"cross_margin_summary_total_margin_used_usd":{"type":"string"},"cross_margin_summary_total_net_liquidation_position_on_usd":{"type":"string"},"cross_margin_summary_total_raw_usd":{"type":"string"},"margin_summary_account_value_usd":{"type":"string"},"margin_summary_total_margin_used_usd":{"type":"string"},"margin_summary_total_net_liquidation_position_usd":{"type":"string"},"margin_summary_total_raw_usd":{"type":"string"},"time":{"type":"integer"},"withdrawable":{"type":"string"}},"type":"object"}},"required":["data"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.01,"price_match":true,"latency_ms":219,"error":null}],"description_full":"Get Perpetual Positions Data","last_updated":"2026-09-22T05:49:57.458Z","schemes":["exact"]}