{"uid":"cap_HK7hUkJQDUWQg5GasjmqU","slug":"nansen-19b780ee","name":"Nansen TGM Position Intelligence","description":"Get \"Token God Mode\" (TGM) position intelligence data","url":"https://api.nansen.ai/api/v1/tgm/position-intelligence","method":"GET","headers":{},"bodySchema":{"type":"object","title":"TGMPositionIntelligenceRequest","required":["token_address"],"properties":{"token_address":{"type":"string","title":"Token Address","examples":["BTC"],"minLength":1,"description":"Token address (for perps and hyperliquid, validation is skipped)"}},"description":"Request model for TGM position-intelligence endpoint.\n\nThis endpoint provides position intelligence analytics for perpetual contracts\non Hyperliquid, showing aggregated position sizes by different trader cohorts.","additionalProperties":false},"responseSchema":{"type":"object","title":"TGMPositionIntelligenceResponse","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","title":"TGMPositionIntelligence","properties":{"whale_longs_usd":{"anyOf":[{"type":"number"}],"title":"Whale Longs Usd","examples":[2000000.5],"description":"Sum of absolute long sizes for addresses labeled Whale."},"whale_total_usd":{"anyOf":[{"type":"number"}],"title":"Whale Total Usd","examples":[3000000.75],"description":"Total absolute position size for addresses labeled Whale."},"whale_shorts_usd":{"anyOf":[{"type":"number"}],"title":"Whale Shorts Usd","examples":[1000000.25],"description":"Sum of absolute short sizes for addresses labeled Whale."},"smart_trader_longs_usd":{"anyOf":[{"type":"number"}],"title":"Smart Trader Longs Usd","examples":[1000000.5],"description":"Sum of absolute long sizes for addresses labeled Smart HL Perps Trader."},"smart_trader_total_usd":{"anyOf":[{"type":"number"}],"title":"Smart Trader Total Usd","examples":[1500000.75],"description":"Total absolute position size for addresses labeled Smart HL Perps Trader."},"public_figure_longs_usd":{"anyOf":[{"type":"number"}],"title":"Public Figure Longs Usd","examples":[500000.5],"description":"Sum of absolute long sizes for addresses labeled Public Figure."},"public_figure_total_usd":{"anyOf":[{"type":"number"}],"title":"Public Figure Total Usd","examples":[750000.75],"description":"Total absolute position size for addresses labeled Public Figure."},"smart_trader_shorts_usd":{"anyOf":[{"type":"number"}],"title":"Smart Trader Shorts Usd","examples":[500000.25],"description":"Sum of absolute short sizes for addresses labeled Smart HL Perps Trader."},"public_figure_shorts_usd":{"anyOf":[{"type":"number"}],"title":"Public Figure Shorts Usd","examples":[250000.25],"description":"Sum of absolute short sizes for addresses labeled Public Figure."}},"description":"Individual TGM position intelligence record.\n\nRepresents aggregated position sizes for different trader cohorts."},"title":"Data","description":"List of TGM position intelligence records"}},"description":"Response model for TGM position-intelligence endpoint.\n\nContains position intelligence data with pagination and metadata."},"example":{"request":{"token_address":"BTC"},"response":{"data":[{"whale_longs_usd":744906768.1439998,"whale_total_usd":1519179674.4300008,"whale_shorts_usd":774272906.2860003,"smart_trader_longs_usd":27360135.032999996,"smart_trader_total_usd":90569928.04199998,"public_figure_longs_usd":19851556.725,"public_figure_total_usd":30241833.303,"smart_trader_shorts_usd":63209793.009,"public_figure_shorts_usd":10390276.578000002}]}},"exampleRequest":{"token_address":"BTC"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kW_ws1sJsfEVo88IcBqaY","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_an_KFPgLY1QlbXDfZdG2b","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves TGM (Top Gaining Managers / Token Governance Market) position intelligence data for on-chain addresses or tokens via Nansen's smart money analytics platform","exampleAgentPrompt":"Pull Nansen TGM position intelligence data for the token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum so I can see what top gaining managers are positioned in.","exampleUseCases":[{"title":"Smart money sentiment on altcoin","prompt":"Check what Nansen's top gaining managers are positioned in for the token at 0x6B175474E89094C44Da98b954EedeAC495271d0F — I want to know if smart money is net long or short before I make a move."},{"title":"Whale positioning before major catalyst","prompt":"Pull up the TGM position intelligence for BTC perps on Hyperliquid so I can see how whales and top PnL traders are positioned heading into this week's macro event."},{"title":"Compare smart money across two tokens","prompt":"Get me Nansen TGM position data for both 0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599 and 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 so I can compare how institutional and smart money wallets are split between the two assets."}],"resultDescription":"Returns structured TGM position intelligence data including position sizes, holder breakdowns, smart money wallet positions, and related on-chain analytics for the queried token or address as curated by Nansen's wallet labeling and flow tracking systems.","failureModes":["Invalid or unsupported token/contract address returns a 400 error","Token not tracked by Nansen TGM returns empty or null result","Missing required body parameters returns validation error","Insufficient payment or x402 payment failure returns 402 error","Rate limiting or quota exceeded returns 429 error"],"whenToPreferThis":"Choose this endpoint when you need institutional-grade on-chain position intelligence specifically from Nansen's TGM (Top Gaining Managers) dataset — particularly when analyzing which smart money or high-performing wallets hold significant positions in a token. Prefer this over generic holder APIs when you want Nansen's curated wallet labels and smart money categorization rather than raw on-chain data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:45:54.936Z","isFirstParty":false}