{"openapi":"3.1.0","info":{"title":"SmartPerps","version":"0.1.1","contact":{"name":"SmartPerps","email":"hello@youraitools.co","url":"https://agentgate-source.pages.dev/x402-smartperps/"},"license":{"name":"MIT"},"x-service-name":"SmartPerps by AgentGate","x-category":"trading","x-categories":["trading","market-data","smart-money","defi","crypto"],"x-tags":["smart-money","hyperliquid","perps","trading","market-data"],"x-logo":{"url":"https://agentgate-source.pages.dev/icons/smartperps.png"},"description":"Smart-money positioning on Hyperliquid perps for trading agents: how a rules-based cohort of the 120 Hyperliquid accounts with the highest 30-day PnL (public leaderboard) is positioned in any coin right now: traders long vs short, long/short notional, net bias, 1h/4h/24h net flows, average entry and leverage, liquidation price bands and the largest positions (addresses truncated); a market-wide scan of the coins the cohort is most net long, net short and one-sided on; and a live profile of a Hyperliquid account you supply. Public on-chain data only (not for targeting or harassing account holders), snapshot every 5 minutes, fail-closed. Read-only analytics, paid per call over x402 or with prepaid credits; free preview and remote MCP. Not financial advice. Not financial advice. Past performance does not guarantee future results. Descriptive statistics of public Hyperliquid positions at snapshot time; past PnL of the cohort says nothing about future results and positions can change at any moment. SmartPerps never trades, holds funds or keys.","x-guidance":"GET /v1/lite?symbol=BTC ($0.003); GET /v1/coin?symbol=ETH ($0.02); GET /v1/scan?limit=10 ($0.03); GET /v1/wallet?address=0x0000000000000000000000000000000000000001 ($0.01). POST the same fields as JSON. USDC via x402 (Base, Polygon, Arbitrum One, Solana), charged only on HTTP 200. Free: /v1/preview?symbol=BTC."},"servers":[{"url":"https://api.youraitools.co/smartperps"}],"externalDocs":{"description":"Source and docs","url":"https://agentgate-source.pages.dev/x402-smartperps/"},"paths":{"/v1/lite":{"get":{"operationId":"smart_money_lite","summary":"Smart-money bias for one Hyperliquid coin: cohort traders long vs short, long/short/net notional, bias label, 1h and 24h net flow ($0.003)","description":"Smart-money positioning for one Hyperliquid perp: how a rules-based cohort of the 120 Hyperliquid accounts with the highest 30-day PnL (public leaderboard) is positioned right now: traders long vs short, long/short/net notional in USD, bias (strong long / lean long / mixed / lean short / strong short), 1h and 24h net notional flow, snapshot age, cohort coverage. Fail-closed: stale or low-coverage snapshots are refused (503, not charged). Not financial advice.","tags":["paid"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003"},"protocols":[{"x402":{}}]},"x-x402":{"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F","amount":"3000","assetSymbol":"USDC","x402Versions":[2,1],"networks":[{"network":"eip155:8453","name":"Base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:137","name":"Polygon","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:42161","name":"Arbitrum One","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","name":"Solana","asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","symbol":"USDC","payTo":"FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte"}]},"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Hyperliquid perp ticker, e.g. BTC, ETH, SOL, HYPE, kPEPE (BTC-PERP, ETH-USD, SOLUSDT accepted)"}],"responses":{"200":{"description":"Cohort traders long/short, long/short/net notional, long share by notional and by traders, bias label, 1h/24h net flow, mark price, snapshot age, coverage, confidence, sources_failed. (payment settled)","content":{"application/json":{"example":{"symbol":"BTC","bias":"strong_short","bias_note":"Most of the cohort's notional and most cohort traders in this coin are short.","traders_long":8,"traders_short":37,"long_notional_usd":23033122,"short_notional_usd":843673444,"net_notional_usd":-820640322,"long_share_notional_pct":2.7,"long_share_traders_pct":17.8,"mark_price":81380,"flow_1h_net_usd":null,"flow_24h_net_usd":null,"snapshot_at":"2026-10-23T01:08:26.080Z","snapshot_age_s":4,"cohort":{"size":120,"covered":120,"coverage_pct":100,"cohort_refreshed_at":"2026-10-23T01:08:26.080Z"},"confidence":"high","sources_failed":[],"checked_at":"2026-10-23T01:08:30.196Z","tier":"lite","disclaimer":"Not financial advice. Past performance does not guarantee future results. Descriptive statistics of public Hyperliquid positions at snapshot time; past PnL of the cohort says nothing about future results and positions can change at any moment. SmartPerps never trades, holds funds or keys."}}}},"400":{"description":"Invalid input (never charged)"},"402":{"description":"Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)"},"404":{"description":"Symbol not listed (never charged)"},"503":{"description":"Data sources unavailable: upstream_unavailable with sources_failed (never charged)"}}},"post":{"operationId":"smart_money_lite_post","summary":"Same as GET, POST {\"symbol\":\"BTC\"}","tags":["paid"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003"},"protocols":[{"x402":{}}]},"x-x402":{"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F","amount":"3000","assetSymbol":"USDC","x402Versions":[2,1],"networks":[{"network":"eip155:8453","name":"Base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:137","name":"Polygon","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:42161","name":"Arbitrum One","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","name":"Solana","asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","symbol":"USDC","payTo":"FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte"}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string","description":"Hyperliquid perp ticker, e.g. BTC, ETH, SOL, HYPE, kPEPE (BTC-PERP, ETH-USD, SOLUSDT accepted)"}},"required":["symbol"]}}}},"responses":{"200":{"description":"Cohort traders long/short, long/short/net notional, long share by notional and by traders, bias label, 1h/24h net flow, mark price, snapshot age, coverage, confidence, sources_failed. (payment settled)","content":{"application/json":{"example":{"symbol":"BTC","bias":"strong_short","bias_note":"Most of the cohort's notional and most cohort traders in this coin are short.","traders_long":8,"traders_short":37,"long_notional_usd":23033122,"short_notional_usd":843673444,"net_notional_usd":-820640322,"long_share_notional_pct":2.7,"long_share_traders_pct":17.8,"mark_price":81380,"flow_1h_net_usd":null,"flow_24h_net_usd":null,"snapshot_at":"2026-10-23T01:08:26.080Z","snapshot_age_s":4,"cohort":{"size":120,"covered":120,"coverage_pct":100,"cohort_refreshed_at":"2026-10-23T01:08:26.080Z"},"confidence":"high","sources_failed":[],"checked_at":"2026-10-23T01:08:30.196Z","tier":"lite","disclaimer":"Not financial advice. Past performance does not guarantee future results. Descriptive statistics of public Hyperliquid positions at snapshot time; past PnL of the cohort says nothing about future results and positions can change at any moment. SmartPerps never trades, holds funds or keys."}}}},"400":{"description":"Invalid input (never charged)"},"402":{"description":"Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)"},"404":{"description":"Symbol not listed (never charged)"},"503":{"description":"Data sources unavailable: upstream_unavailable with sources_failed (never charged)"}}}},"/v1/coin":{"get":{"operationId":"smart_money_coin","summary":"Full smart-money read for one coin: bias, 1h/4h/24h flows, average entry vs mark, leverage, unrealized PnL, liquidation price bands, top 10 cohort positions (addresses truncated) ($0.02)","description":"Full smart-money positioning for one Hyperliquid perp from the top-120 30-day-PnL cohort: lite plus 1h/4h/24h flows, average entry per side vs mark, average leverage, uPnL per side, concentration, liquidation price bands by distance from mark (count and notional per band, never per account) and the 10 largest cohort positions (truncated addresses, no liquidation price). Public on-chain data only. Fail-closed. Not financial advice. Past performance does not guarantee future results.","tags":["paid"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"x-x402":{"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F","amount":"20000","assetSymbol":"USDC","x402Versions":[2,1],"networks":[{"network":"eip155:8453","name":"Base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:137","name":"Polygon","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:42161","name":"Arbitrum One","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","name":"Solana","asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","symbol":"USDC","payTo":"FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte"}]},"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Hyperliquid perp ticker, e.g. BTC, ETH, SOL, HYPE, kPEPE (BTC-PERP, ETH-USD, SOLUSDT accepted)"}],"responses":{"200":{"description":"Lite fields plus flows 1h/4h/24h, avg entry long/short and distance to mark, avg leverage, uPnL per side, concentration, liquidation price bands per side (count + notional), top 10 positions with truncated address and trader rank. (payment settled)","content":{"application/json":{"example":{"symbol":"ETH","bias":"strong_short","bias_note":"Most of the cohort's notional and most cohort traders in this coin are short.","traders_long":10,"traders_short":40,"long_notional_usd":62204218,"short_notional_usd":817401626,"net_notional_usd":-755197408,"long_share_notional_pct":7.1,"long_share_traders_pct":20,"mark_price":2389,"avg_entry_long":2454.489627,"avg_entry_short":2381.656074,"entry_vs_mark_long_pct":-2.67,"entry_vs_mark_short_pct":-0.31,"avg_leverage":12.84,"unrealized_pnl_long_usd":-1704791,"unrealized_pnl_short_usd":-2516812,"largest_position_share_pct":28.9,"concentration_note":null,"flows":{"1h":null,"4h":null,"24h":null},"liquidation_clusters":{"longs":[{"within_pct":"0-2","price_from":2341,"price_to":2389,"notional_usd":0,"positions":0},{"within_pct":"2-5","price_from":2270,"price_to":2341,"notional_usd":0,"positions":0},{"within_pct":"5-10","price_from":2150,"price_to":2270,"notional_usd":0,"positions":0}],"shorts":[{"within_pct":"0-2","price_from":2389,"price_to":2437,"notional_usd":0,"positions":0},{"within_pct":"2-5","price_from":2437,"price_to":2508,"notional_usd":0,"positions":0},{"within_pct":"5-10","price_from":2508,"price_to":2628,"notional_usd":null,"positions":2,"notional_withheld":"fewer than 3 positions"}],"no_liquidation_price_usd":4577002,"bands_note":"Bands by distance of the liquidation price from mark (longs below, shorts above). Notional is withheld for bands with fewer than 3 positions so no band maps to one account."},"top_positions":[{"address":"0x5b5d…c060","side":"short","size":106464.1028,"notional_usd":254342742,"entry_price":2322.73,"leverage":5,"margin":"cross","unrealized_pnl_usd":-7054831,"cohort_rank_30d_pnl":1,"trader_30d_pnl_usd":114316598},{"address":"0xb83d…6e36","side":"short","size":66302.7619,"notional_usd":158397298,"entry_price":2375.32,"leverage":5,"margin":"cross","unrealized_pnl_usd":-906592,"cohort_rank_30d_pnl":2,"trader_30d_pnl_usd":102801123}],"snapshot_at":"2026-10-23T01:08:26.080Z","snapshot_age_s":4,"cohort":{"size":120,"covered":120,"coverage_pct":100,"cohort_refreshed_at":"2026-10-23T01:08:26.080Z"},"confidence":"high","sources_failed":[],"checked_at":"2026-10-23T01:08:30.196Z","tier":"coin","disclaimer":"Not financial advice. Past performance does not guarantee future results. Descriptive statistics of public Hyperliquid positions at snapshot time; past PnL of the cohort says nothing about future results and positions can change at any moment. SmartPerps never trades, holds funds or keys."}}}},"400":{"description":"Invalid input (never charged)"},"402":{"description":"Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)"},"404":{"description":"Symbol not listed (never charged)"},"503":{"description":"Data sources unavailable: upstream_unavailable with sources_failed (never charged)"}}},"post":{"operationId":"smart_money_coin_post","summary":"Same as GET, POST {\"symbol\":\"ETH\"}","tags":["paid"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"x-x402":{"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F","amount":"20000","assetSymbol":"USDC","x402Versions":[2,1],"networks":[{"network":"eip155:8453","name":"Base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:137","name":"Polygon","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:42161","name":"Arbitrum One","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","name":"Solana","asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","symbol":"USDC","payTo":"FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte"}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string","description":"Hyperliquid perp ticker, e.g. BTC, ETH, SOL, HYPE, kPEPE (BTC-PERP, ETH-USD, SOLUSDT accepted)"}},"required":["symbol"]}}}},"responses":{"200":{"description":"Lite fields plus flows 1h/4h/24h, avg entry long/short and distance to mark, avg leverage, uPnL per side, concentration, liquidation price bands per side (count + notional), top 10 positions with truncated address and trader rank. (payment settled)","content":{"application/json":{"example":{"symbol":"ETH","bias":"strong_short","bias_note":"Most of the cohort's notional and most cohort traders in this coin are short.","traders_long":10,"traders_short":40,"long_notional_usd":62204218,"short_notional_usd":817401626,"net_notional_usd":-755197408,"long_share_notional_pct":7.1,"long_share_traders_pct":20,"mark_price":2389,"avg_entry_long":2454.489627,"avg_entry_short":2381.656074,"entry_vs_mark_long_pct":-2.67,"entry_vs_mark_short_pct":-0.31,"avg_leverage":12.84,"unrealized_pnl_long_usd":-1704791,"unrealized_pnl_short_usd":-2516812,"largest_position_share_pct":28.9,"concentration_note":null,"flows":{"1h":null,"4h":null,"24h":null},"liquidation_clusters":{"longs":[{"within_pct":"0-2","price_from":2341,"price_to":2389,"notional_usd":0,"positions":0},{"within_pct":"2-5","price_from":2270,"price_to":2341,"notional_usd":0,"positions":0},{"within_pct":"5-10","price_from":2150,"price_to":2270,"notional_usd":0,"positions":0}],"shorts":[{"within_pct":"0-2","price_from":2389,"price_to":2437,"notional_usd":0,"positions":0},{"within_pct":"2-5","price_from":2437,"price_to":2508,"notional_usd":0,"positions":0},{"within_pct":"5-10","price_from":2508,"price_to":2628,"notional_usd":null,"positions":2,"notional_withheld":"fewer than 3 positions"}],"no_liquidation_price_usd":4577002,"bands_note":"Bands by distance of the liquidation price from mark (longs below, shorts above). Notional is withheld for bands with fewer than 3 positions so no band maps to one account."},"top_positions":[{"address":"0x5b5d…c060","side":"short","size":106464.1028,"notional_usd":254342742,"entry_price":2322.73,"leverage":5,"margin":"cross","unrealized_pnl_usd":-7054831,"cohort_rank_30d_pnl":1,"trader_30d_pnl_usd":114316598},{"address":"0xb83d…6e36","side":"short","size":66302.7619,"notional_usd":158397298,"entry_price":2375.32,"leverage":5,"margin":"cross","unrealized_pnl_usd":-906592,"cohort_rank_30d_pnl":2,"trader_30d_pnl_usd":102801123}],"snapshot_at":"2026-10-23T01:08:26.080Z","snapshot_age_s":4,"cohort":{"size":120,"covered":120,"coverage_pct":100,"cohort_refreshed_at":"2026-10-23T01:08:26.080Z"},"confidence":"high","sources_failed":[],"checked_at":"2026-10-23T01:08:30.196Z","tier":"coin","disclaimer":"Not financial advice. Past performance does not guarantee future results. Descriptive statistics of public Hyperliquid positions at snapshot time; past PnL of the cohort says nothing about future results and positions can change at any moment. SmartPerps never trades, holds funds or keys."}}}},"400":{"description":"Invalid input (never charged)"},"402":{"description":"Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)"},"404":{"description":"Symbol not listed (never charged)"},"503":{"description":"Data sources unavailable: upstream_unavailable with sources_failed (never charged)"}}}},"/v1/scan":{"get":{"operationId":"smart_money_scan","summary":"Market-wide smart-money scan: coins the cohort is most net long, most net short and most one-sided on, biggest 24h buying and selling, cohort gross book ($0.03)","description":"Market-wide smart-money scan over every Hyperliquid perp held by the top-120 30-day-PnL cohort: the cohort gross long/short book and net exposure, and ranked lists of the coins it is most net long, most net short and most one-sided on (by trader count), plus the biggest 24h net buying and selling by notional, each with bias, trader counts, net notional and flows. limit 1-25 rows per list, min_traders 2-50 (default 3). Fail-closed. Not financial advice.","tags":["paid"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]},"x-x402":{"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F","amount":"30000","assetSymbol":"USDC","x402Versions":[2,1],"networks":[{"network":"eip155:8453","name":"Base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:137","name":"Polygon","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:42161","name":"Arbitrum One","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","name":"Solana","asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","symbol":"USDC","payTo":"FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte"}]},"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Rows per list, 1-25 (default 10)"},{"name":"min_traders","in":"query","required":false,"schema":{"type":"integer"},"description":"Only rank coins held by at least this many cohort accounts, 2-50 (default 3)"}],"responses":{"200":{"description":"Cohort book (gross long/short, net, long share, accounts with positions, equity) and lists most_net_long, most_net_short, most_one_sided, biggest_24h_buying, biggest_24h_selling. (payment settled)","content":{"application/json":{"example":{"mode":"cohort","coins_held":178,"coins_ranked":146,"min_traders":3,"cohort_book":{"gross_long_usd":206948229,"gross_short_usd":2898762302,"net_usd":-2691814073,"long_share_pct":6.7,"accounts_with_positions":83,"equity_usd":702970565},"most_net_long":[{"symbol":"AAVE","bias":"mixed","traders_long":5,"traders_short":13,"net_notional_usd":1003728,"long_share_notional_pct":52.5,"flow_1h_net_usd":null,"flow_24h_net_usd":null},{"symbol":"ATOM","bias":"strong_long","traders_long":5,"traders_short":1,"net_notional_usd":972941,"long_share_notional_pct":96,"flow_1h_net_usd":null,"flow_24h_net_usd":null}],"most_net_short":[{"symbol":"BTC","bias":"strong_short","traders_long":8,"traders_short":37,"net_notional_usd":-820640322,"long_share_notional_pct":2.7,"flow_1h_net_usd":null,"flow_24h_net_usd":null},{"symbol":"ETH","bias":"strong_short","traders_long":10,"traders_short":40,"net_notional_usd":-755197408,"long_share_notional_pct":7.1,"flow_1h_net_usd":null,"flow_24h_net_usd":null}],"most_one_sided":[{"symbol":"XPL","bias":"strong_short","traders_long":0,"traders_short":20,"net_notional_usd":-14667723,"long_share_notional_pct":0,"flow_1h_net_usd":null,"flow_24h_net_usd":null},{"symbol":"AERO","bias":"strong_short","traders_long":0,"traders_short":12,"net_notional_usd":-2620964,"long_share_notional_pct":0,"flow_1h_net_usd":null,"flow_24h_net_usd":null}],"biggest_24h_buying":[],"biggest_24h_selling":[],"flows_note":"Flow history builds up over the first 24 hours after launch; flow lists are empty until a 24h-old snapshot exists.","snapshot_at":"2026-10-23T01:08:26.080Z","snapshot_age_s":4,"cohort":{"size":120,"covered":120,"coverage_pct":100,"cohort_refreshed_at":"2026-10-23T01:08:26.080Z"},"confidence":"high","sources_failed":[],"checked_at":"2026-10-23T01:08:30.196Z","tier":"scan","disclaimer":"Not financial advice. Past performance does not guarantee future results. Descriptive statistics of public Hyperliquid positions at snapshot time; past PnL of the cohort says nothing about future results and positions can change at any moment. SmartPerps never trades, holds funds or keys."}}}},"400":{"description":"Invalid input (never charged)"},"402":{"description":"Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)"},"404":{"description":"Symbol not listed (never charged)"},"503":{"description":"Data sources unavailable: upstream_unavailable with sources_failed (never charged)"}}},"post":{"operationId":"smart_money_scan_post","summary":"Same as GET, POST {\"limit\":10}","tags":["paid"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]},"x-x402":{"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F","amount":"30000","assetSymbol":"USDC","x402Versions":[2,1],"networks":[{"network":"eip155:8453","name":"Base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:137","name":"Polygon","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:42161","name":"Arbitrum One","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","name":"Solana","asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","symbol":"USDC","payTo":"FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte"}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"integer","description":"Rows per list, 1-25 (default 10)"},"min_traders":{"type":"integer","description":"Only rank coins held by at least this many cohort accounts, 2-50 (default 3)"}}}}}},"responses":{"200":{"description":"Cohort book (gross long/short, net, long share, accounts with positions, equity) and lists most_net_long, most_net_short, most_one_sided, biggest_24h_buying, biggest_24h_selling. (payment settled)","content":{"application/json":{"example":{"mode":"cohort","coins_held":178,"coins_ranked":146,"min_traders":3,"cohort_book":{"gross_long_usd":206948229,"gross_short_usd":2898762302,"net_usd":-2691814073,"long_share_pct":6.7,"accounts_with_positions":83,"equity_usd":702970565},"most_net_long":[{"symbol":"AAVE","bias":"mixed","traders_long":5,"traders_short":13,"net_notional_usd":1003728,"long_share_notional_pct":52.5,"flow_1h_net_usd":null,"flow_24h_net_usd":null},{"symbol":"ATOM","bias":"strong_long","traders_long":5,"traders_short":1,"net_notional_usd":972941,"long_share_notional_pct":96,"flow_1h_net_usd":null,"flow_24h_net_usd":null}],"most_net_short":[{"symbol":"BTC","bias":"strong_short","traders_long":8,"traders_short":37,"net_notional_usd":-820640322,"long_share_notional_pct":2.7,"flow_1h_net_usd":null,"flow_24h_net_usd":null},{"symbol":"ETH","bias":"strong_short","traders_long":10,"traders_short":40,"net_notional_usd":-755197408,"long_share_notional_pct":7.1,"flow_1h_net_usd":null,"flow_24h_net_usd":null}],"most_one_sided":[{"symbol":"XPL","bias":"strong_short","traders_long":0,"traders_short":20,"net_notional_usd":-14667723,"long_share_notional_pct":0,"flow_1h_net_usd":null,"flow_24h_net_usd":null},{"symbol":"AERO","bias":"strong_short","traders_long":0,"traders_short":12,"net_notional_usd":-2620964,"long_share_notional_pct":0,"flow_1h_net_usd":null,"flow_24h_net_usd":null}],"biggest_24h_buying":[],"biggest_24h_selling":[],"flows_note":"Flow history builds up over the first 24 hours after launch; flow lists are empty until a 24h-old snapshot exists.","snapshot_at":"2026-10-23T01:08:26.080Z","snapshot_age_s":4,"cohort":{"size":120,"covered":120,"coverage_pct":100,"cohort_refreshed_at":"2026-10-23T01:08:26.080Z"},"confidence":"high","sources_failed":[],"checked_at":"2026-10-23T01:08:30.196Z","tier":"scan","disclaimer":"Not financial advice. Past performance does not guarantee future results. Descriptive statistics of public Hyperliquid positions at snapshot time; past PnL of the cohort says nothing about future results and positions can change at any moment. SmartPerps never trades, holds funds or keys."}}}},"400":{"description":"Invalid input (never charged)"},"402":{"description":"Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)"},"404":{"description":"Symbol not listed (never charged)"},"503":{"description":"Data sources unavailable: upstream_unavailable with sources_failed (never charged)"}}}},"/v1/wallet":{"get":{"operationId":"hyperliquid_wallet_profile","summary":"Live profile of a Hyperliquid account you supply: equity, leverage, margin usage, open positions with distance to liquidation (whole %), 30-day fills (volume, realized PnL, fees, win rate), cohort rank. Public on-chain data only ($0.01)","description":"Live profile of the Hyperliquid account (0x address) you supply: account value, notional, effective leverage, margin usage, long/short/net book, up to 25 open positions (size, entry, leverage, distance to liquidation in whole percent, uPnL; no liquidation prices), 30-day fills summary and top-120 cohort rank. Public on-chain data only; must not be used to target or harass account holders. Fail-closed. Not financial advice. Past performance does not guarantee future results.","tags":["paid"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"x-x402":{"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F","amount":"10000","assetSymbol":"USDC","x402Versions":[2,1],"networks":[{"network":"eip155:8453","name":"Base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:137","name":"Polygon","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:42161","name":"Arbitrum One","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","name":"Solana","asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","symbol":"USDC","payTo":"FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte"}]},"parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string"},"description":"Hyperliquid account address (0x + 40 hex)"}],"responses":{"200":{"description":"Equity, notional, leverage, margin usage, book, open positions with distance to liquidation (whole %), 30-day fills summary, cohort membership and rank, data_note, confidence, sources_failed. Public on-chain data only; not for targeting or harassing account holders. (payment settled)","content":{"application/json":{"example":{"address":"0x0000000000000000000000000000000000000001","account_value_usd":151226719,"total_notional_usd":700946583,"margin_used_usd":148682072,"margin_usage_pct":98.3,"effective_leverage":4.64,"open_positions":19,"book":{"long_notional_usd":0,"short_notional_usd":700946583,"net_usd":-700946583},"positions":[{"symbol":"ETH","side":"short","size":106464.1028,"notional_usd":254365099,"entry_price":2322.73,"leverage":5,"margin":"cross","liquidation_distance_pct":74,"unrealized_pnl_usd":-7077189},{"symbol":"BTC","side":"short","size":2637.9539,"notional_usd":214683283,"entry_price":76327.4,"leverage":5,"margin":"cross","liquidation_distance_pct":88,"unrealized_pnl_usd":-13335028}],"last_30d":{"window_days":30,"fills":2000,"truncated":true,"volume_usd":763893,"realized_pnl_usd":-7535,"fees_usd":73,"closing_fills":64,"winning_closes_pct":76.6,"most_traded":[{"symbol":"xyz:META","volume_usd":453357},{"symbol":"HYPE","volume_usd":165242}]},"in_smart_money_cohort":true,"cohort_entry":{"rank_30d_pnl":1,"pnl_30d_usd":114316598,"pnl_all_time_usd":179019894,"roi_30d":0.6858,"display_name":null},"confidence":"high","sources_failed":[],"data_note":"Public on-chain Hyperliquid data only. Liquidation is shown as distance from mark in whole percent, not as a price. Do not use this data to target, front-run liquidations of, or harass account holders.","checked_at":"2026-10-23T01:08:30.196Z","tier":"wallet","disclaimer":"Not financial advice. Past performance does not guarantee future results. Descriptive statistics of public Hyperliquid positions at snapshot time; past PnL of the cohort says nothing about future results and positions can change at any moment. SmartPerps never trades, holds funds or keys."}}}},"400":{"description":"Invalid input (never charged)"},"402":{"description":"Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)"},"404":{"description":"Symbol not listed (never charged)"},"503":{"description":"Data sources unavailable: upstream_unavailable with sources_failed (never charged)"}}},"post":{"operationId":"hyperliquid_wallet_profile_post","summary":"Same as GET, POST {\"address\":\"0x0000000000000000000000000000000000000001\"}","tags":["paid"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"x-x402":{"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F","amount":"10000","assetSymbol":"USDC","x402Versions":[2,1],"networks":[{"network":"eip155:8453","name":"Base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:137","name":"Polygon","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:42161","name":"Arbitrum One","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","name":"Solana","asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","symbol":"USDC","payTo":"FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte"}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","description":"Hyperliquid account address (0x + 40 hex)"}},"required":["address"]}}}},"responses":{"200":{"description":"Equity, notional, leverage, margin usage, book, open positions with distance to liquidation (whole %), 30-day fills summary, cohort membership and rank, data_note, confidence, sources_failed. Public on-chain data only; not for targeting or harassing account holders. (payment settled)","content":{"application/json":{"example":{"address":"0x0000000000000000000000000000000000000001","account_value_usd":151226719,"total_notional_usd":700946583,"margin_used_usd":148682072,"margin_usage_pct":98.3,"effective_leverage":4.64,"open_positions":19,"book":{"long_notional_usd":0,"short_notional_usd":700946583,"net_usd":-700946583},"positions":[{"symbol":"ETH","side":"short","size":106464.1028,"notional_usd":254365099,"entry_price":2322.73,"leverage":5,"margin":"cross","liquidation_distance_pct":74,"unrealized_pnl_usd":-7077189},{"symbol":"BTC","side":"short","size":2637.9539,"notional_usd":214683283,"entry_price":76327.4,"leverage":5,"margin":"cross","liquidation_distance_pct":88,"unrealized_pnl_usd":-13335028}],"last_30d":{"window_days":30,"fills":2000,"truncated":true,"volume_usd":763893,"realized_pnl_usd":-7535,"fees_usd":73,"closing_fills":64,"winning_closes_pct":76.6,"most_traded":[{"symbol":"xyz:META","volume_usd":453357},{"symbol":"HYPE","volume_usd":165242}]},"in_smart_money_cohort":true,"cohort_entry":{"rank_30d_pnl":1,"pnl_30d_usd":114316598,"pnl_all_time_usd":179019894,"roi_30d":0.6858,"display_name":null},"confidence":"high","sources_failed":[],"data_note":"Public on-chain Hyperliquid data only. Liquidation is shown as distance from mark in whole percent, not as a price. Do not use this data to target, front-run liquidations of, or harass account holders.","checked_at":"2026-10-23T01:08:30.196Z","tier":"wallet","disclaimer":"Not financial advice. Past performance does not guarantee future results. Descriptive statistics of public Hyperliquid positions at snapshot time; past PnL of the cohort says nothing about future results and positions can change at any moment. SmartPerps never trades, holds funds or keys."}}}},"400":{"description":"Invalid input (never charged)"},"402":{"description":"Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body)"},"404":{"description":"Symbol not listed (never charged)"},"503":{"description":"Data sources unavailable: upstream_unavailable with sources_failed (never charged)"}}}},"/v1/preview":{"get":{"operationId":"smartperps_preview","summary":"Free: bias label, cohort traders long/short, snapshot age, coverage, confidence (no notional, flows or positions), 10/min per IP","security":[],"parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string"},"description":"Hyperliquid perp ticker, e.g. BTC, ETH, SOL, HYPE, kPEPE (BTC-PERP, ETH-USD, SOLUSDT accepted)"}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"429":{"description":"Free tier rate limit"},"503":{"description":"Data sources unavailable"}}}}},"x-x402-networks":[{"network":"eip155:8453","name":"Base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:137","name":"Polygon","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:42161","name":"Arbitrum One","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","name":"Solana","asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","symbol":"USDC","payTo":"FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte"}]}