{"slug":"api-nansen-ai-api-v1-smart-money-perp-trades-2b1206","title":"Get Smart Money Perpetual Trades Data","host":"api.nansen.ai","method":"POST","resource":"https://api.nansen.ai/api/v1/smart-money/perp-trades","category":"other","description":"Get Smart Money Perpetual Trades Data","price_listed":0.05,"price_asked":null,"state":"effects","state_label":"Not tested: has real-world effects","checks_7d":0,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":53,"reported_payers_30d":6,"networks":["eip155:143","eip155:196","eip155:56","eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"filters":{"action":"Buy - Add Long","side":"Long","token_symbol":"BTC","type":"Limit","value_usd":{"max":10000,"min":1000}},"lookback_hours":24,"only_new_positions":true},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"filters":{"type":"object"},"lookback_hours":{"type":"integer"},"only_new_positions":{"type":"boolean"},"order_by":{"type":"array"},"pagination":{"type":"object"},"premium_labels":{"type":"boolean"}},"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":{"items":{"properties":{"action":{"type":"string"},"block_timestamp":{"type":"string"},"price_usd":{"type":"number"},"side":{"type":"string"},"token_amount":{"type":"number"},"token_symbol":{"type":"string"},"trader_address":{"type":"string"},"trader_address_label":{"type":"string"},"transaction_hash":{"type":"string"},"type":{"type":"string"},"value_usd":{"type":"number"}},"required":["trader_address_label","trader_address","token_symbol","action","type","block_timestamp","transaction_hash"],"type":"object"},"type":"array"},"pagination":{"properties":{"is_last_page":{"type":"boolean"},"page":{"type":"integer"},"per_page":{"type":"integer"}},"type":"object"}},"required":["data","pagination"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"Get Smart Money Perpetual Trades Data","last_updated":"2026-09-23T00:07:47.763Z","schemes":["exact"]}