{"uid":"cap_FqwfQ4OqHNPHz67Gx_HSJ","slug":"api-nansen-ai-04e4e036","name":"Nansen Token God Mode DEX Trades","description":"Get \"Token God Mode\" (TGM) DEX trades data","url":"https://api.nansen.ai/api/v1/tgm/dex-trades","method":"GET","headers":{},"bodySchema":{"type":"object","title":"TGMDexTradesRequest","required":["chain","token_address","date"],"properties":{"date":{"type":"object","title":"DateRange","properties":{"to":{"anyOf":[{"type":"string"}],"title":"To","examples":["2025-01-31T23:59:59Z"],"description":"End date in ISO 8601 format (e.g., 2025-01-31T23:59:59Z or 2025-01-31)"},"from":{"anyOf":[{"type":"string"}],"title":"From","examples":["2025-01-01T00:00:00Z"],"description":"Start date in ISO 8601 format (e.g., 2025-01-01T00:00:00Z or 2025-01-01)"}},"description":"Date range model matching the API schema."},"chain":{"enum":["arbitrum","avalanche","base","bnb","ethereum","hyperevm","injective","iotaevm","linea","mantle","mantra","monad","near","optimism","plasma","polygon","ronin","scroll","sei","solana","sonic","starknet","sui","ton","tron"],"type":"string","title":"TGMChain","description":"Chains supported in TGM (Token God Mode) endpoints."},"filters":{"anyOf":[{"type":"object","title":"TGMDexTradesFilters","properties":{"action":{"anyOf":[{"enum":["BUY","SELL"],"type":"string","title":"TGMWhoBoughtSoldType","description":"TGM who bought/sold type."}],"examples":["BUY","SELL"],"description":"Action filter (BUY/SELL)"},"token_name":{"anyOf":[{"type":"string"}],"title":"Token Name","examples":["USDC","%Uniswap%"],"description":"Token name filter"},"token_amount":{"anyOf":[{"type":"object","title":"NumericRangeFilter","properties":{"max":{"anyOf":[{"type":"number"}],"title":"Max","examples":[50000,10000000,100],"description":"Maximum value (inclusive)"},"min":{"anyOf":[{"type":"number"}],"title":"Min","examples":[1000,1000000,-50,0],"description":"Minimum value (inclusive)"}},"description":"Filter for numeric values (floats) with optional min/max bounds.\nUse for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75"}],"examples":[{"min":100}],"description":"Token amount range filter"},"token_address":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Token Address","examples":["0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"],"description":"Token address filter"},"trader_address":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Trader Address","examples":["0x28c6c06298d514db089934071355e5743bf21d60"],"description":"Trader address filter"},"block_timestamp":{"anyOf":[{"type":"object","title":"DateRangeFilter","properties":{"to":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string"},{"type":"null"}],"title":"To","examples":["2025-01-31T23:59:59Z"],"description":"End date (inclusive), ISO 8601 format (e.g., 2025-01-31T23:59:59Z or 2025-01-31)"},"from":{"anyOf":[{"type":"string","format":"date-time"},{"type":"string"},{"type":"null"}],"title":"From","examples":["2025-01-01T00:00:00Z"],"description":"Start date (inclusive), ISO 8601 format (e.g., 2025-01-01T00:00:00Z or 2025-01-01)"}},"description":"Filter for date ranges with optional from/to bounds. - Date range"}],"examples":[{"to":"2025-01-31T23:59:59Z","from":"2025-01-01T00:00:00Z"}],"description":"Date range filter for trade timestamps"},"transaction_hash":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Transaction Hash","examples":["0x61adb6da30853c5988f0204dd9f6e4abbc878e02c34030a4f707cf4ec3124bcb"],"description":"Transaction hash filter"},"traded_token_name":{"anyOf":[{"type":"string"}],"title":"Traded Token Name","examples":["DAI","%Maker%"],"description":"Traded token name filter"},"estimated_value_usd":{"anyOf":[{"type":"object","title":"NumericRangeFilter","properties":{"max":{"anyOf":[{"type":"number"}],"title":"Max","examples":[50000,10000000,100],"description":"Maximum value (inclusive)"},"min":{"anyOf":[{"type":"number"}],"title":"Min","examples":[1000,1000000,-50,0],"description":"Minimum value (inclusive)"}},"description":"Filter for numeric values (floats) with optional min/max bounds.\nUse for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75"}],"examples":[{"min":1000}],"description":"Estimated value range filter in USD"},"traded_token_amount":{"anyOf":[{"type":"object","title":"NumericRangeFilter","properties":{"max":{"anyOf":[{"type":"number"}],"title":"Max","examples":[50000,10000000,100],"description":"Maximum value (inclusive)"},"min":{"anyOf":[{"type":"number"}],"title":"Min","examples":[1000,1000000,-50,0],"description":"Minimum value (inclusive)"}},"description":"Filter for numeric values (floats) with optional min/max bounds.\nUse for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75"}],"examples":[{"min":100}],"description":"Traded token amount range filter"},"traded_token_address":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Traded Token Address","examples":["0x1234...","%DAI%"],"description":"Traded token address filter"},"trader_address_label":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Trader Address Label","examples":["High Gas Consumer"],"description":"Trader name filter"},"estimated_swap_price_usd":{"anyOf":[{"type":"object","title":"NumericRangeFilter","properties":{"max":{"anyOf":[{"type":"number"}],"title":"Max","examples":[50000,10000000,100],"description":"Maximum value (inclusive)"},"min":{"anyOf":[{"type":"number"}],"title":"Min","examples":[1000,1000000,-50,0],"description":"Minimum value (inclusive)"}},"description":"Filter for numeric values (floats) with optional min/max bounds.\nUse for prices, volumes, ratios, and other decimal values. - Values between -10.5 and 100.75"}],"examples":[{"min":0.01}],"description":"Estimated swap price range filter in USD"},"exclude_smart_money_labels":{"anyOf":[{"type":"array","items":{"enum":["30D Smart Trader","90D Smart Trader","180D Smart Trader","Fund","Smart Trader","Public Figure","Exchange","Whale","BananaGun Bot User","Top Maestro Bot User","Top BananaGun Bot User","Maestro Bot User","Early MAGIC Miner","First Mover LP","First Mover Staking","Profitable LP","Smart HL Perps Trader"],"type":"string","title":"LabelType","description":"Filter by entity label type."}}],"title":"Exclude Smart Money Labels","examples":[["Public Figure"],["Exchange"]],"description":"Exclude smart money labels for counterparties"},"include_smart_money_labels":{"anyOf":[{"type":"array","items":{"enum":["30D Smart Trader","90D Smart Trader","180D Smart Trader","Fund","Smart Trader","Public Figure","Exchange","Whale","BananaGun Bot User","Top Maestro Bot User","Top BananaGun Bot User","Maestro Bot User","Early MAGIC Miner","First Mover LP","First Mover Staking","Profitable LP","Smart HL Perps Trader"],"type":"string","title":"LabelType","description":"Filter by entity label type."}}],"title":"Include Smart Money Labels","examples":[["Public Figure"],["Exchange"]],"description":"Include smart money labels for counterparties"}},"description":"Filters for TGM DEX trades endpoint.\n\nThese filters control which DEX trades are included in the analysis.","additionalProperties":false}],"examples":[{"action":"BUY","token_amount":{"min":100},"estimated_value_usd":{"min":1000},"include_smart_money_labels":["Whale","Smart Trader"]}],"description":"Additional filters to apply to the query."},"order_by":{"anyOf":[{"type":"array","items":{"type":"object","title":"SortOrder[TGMDexTradesSortField]","required":["field","direction"],"properties":{"field":{"enum":["block_timestamp","transaction_hash","trader_address","trader_address_label","token_address","action","token_name","token_amount","traded_token_address","traded_token_name","traded_token_amount","estimated_swap_price_usd","estimated_value_usd"],"type":"string","title":"TGMDexTradesSortField","description":"Enum for sortable fields in TGM DEX trades."},"direction":{"enum":["ASC","DESC"],"type":"string","title":"SortDirection","description":"Enum for sort directions."}}}}],"title":"Order By","description":"Custom sort order to override the endpoint's default ordering.\n\nExamples:\n- [{\"field\": \"block_timestamp\", \"direction\": \"DESC\"}] - Sort by timestamp descending\n- [{\"field\": \"estimated_value_usd\", \"direction\": \"ASC\"}] - Sort by estimated value ascending\n- [{\"field\": \"token_amount\", \"direction\": \"DESC\"}] - Sort by token amount descending"},"pagination":{"type":"object","title":"PaginationRequest","properties":{"page":{"type":"integer","title":"Page","default":1,"minimum":1,"description":"Page number (1-based)"},"per_page":{"type":"integer","title":"Per Page","default":10,"maximum":1000,"minimum":1,"description":"Number of records per page (max 1000)"}},"description":"Pagination parameters for API requests."},"token_address":{"type":"string","title":"Token Address","examples":["2zMMhcVQEXDtdE6vsFS7S7D5oUodfJHE8vd1gnBouauv"],"description":"Token address"},"only_smart_money":{"type":"boolean","title":"Only Smart Money","default":false,"examples":[false],"description":"Returns only the DEX Trades made by Smart Money wallets"}},"description":"Request model for TGM dex-trades endpoint.\n\nThis endpoint provides all DEX trades for a specific token with optional filtering\nfor smart money wallets only.","additionalProperties":false},"responseSchema":{"type":"object","title":"TGMDexTradesResponse","required":["data","pagination"],"properties":{"data":{"type":"array","items":{"type":"object","title":"TGMDexTrade","required":["block_timestamp","transaction_hash","trader_address","action","token_address","token_name","token_amount","traded_token_address","traded_token_name","traded_token_amount","estimated_swap_price_usd","estimated_value_usd"],"properties":{"action":{"enum":["BUY","SELL"],"type":"string","title":"TGMWhoBoughtSoldType","description":"TGM who bought/sold type."},"token_name":{"type":"string","title":"Token Name","examples":["USDC"],"description":"The name of the token"},"token_amount":{"anyOf":[{"type":"number"}],"title":"Token Amount","examples":[1000],"description":"The amount of the specified token traded"},"token_address":{"type":"string","title":"Token Address","examples":["0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"],"description":"Address of token"},"trader_address":{"type":"string","title":"Trader Address","examples":["0x28c6c06298d514db089934071355e5743bf21d60"],"description":"Trader's address"},"block_timestamp":{"type":"string","title":"Block Timestamp","examples":["2025-05-01T12:00:00Z"],"description":"Block timestamp of the trade"},"transaction_hash":{"type":"string","title":"Transaction Hash","examples":["0x61adb6da30853c5988f0204dd9f6e4abbc878e02c34030a4f707cf4ec3124bcb"],"description":"Transaction hash"},"traded_token_name":{"type":"string","title":"Traded Token Name","examples":["DAI"],"description":"The name of the token traded for the specified token"},"estimated_value_usd":{"anyOf":[{"type":"number"}],"title":"Estimated Value Usd","examples":[1500.5],"description":"The estimated value of the trade in USD"},"traded_token_amount":{"anyOf":[{"type":"number"}],"title":"Traded Token Amount","examples":[500],"description":"The amount of the token traded for the specified token"},"traded_token_address":{"type":"string","title":"Traded Token Address","examples":["0x6b175474e89094c44da98b954eedeac495271d0f"],"description":"Address of token"},"trader_address_label":{"anyOf":[{"type":"string"}],"title":"Trader Address Label","examples":["High Gas Consumer"],"description":"Name of the trader, based on nansen_label"},"estimated_swap_price_usd":{"anyOf":[{"type":"number"}],"title":"Estimated Swap Price Usd","examples":[1],"description":"Estimated swap price in USD, derived from the counterpart token's USD value. Falls back to the daily median token price if the counterpart price is unavailable."}},"description":"Individual TGM dex trade record.\n\nRepresents a single DEX trade for a specific token."},"title":"Data","description":"List of TGM DEX trade records"},"pagination":{"type":"object","title":"PaginationInfo","properties":{"page":{"type":"integer","title":"Page","default":1,"minimum":1,"description":"Current page number"},"per_page":{"type":"integer","title":"Per Page","default":10,"maximum":1000,"minimum":1,"description":"Number of records per page"},"is_last_page":{"type":"boolean","title":"Is Last Page","default":true,"description":"Whether this is the last page"}},"description":"Pagination information for API responses."}},"description":"Response model for TGM dex-trades endpoint.\n\nContains a list of DEX trade records with pagination and metadata."},"example":{"request":{"date":{"to":"2025-01-07T23:59:59Z","from":"2025-01-01T00:00:00Z"},"chain":"ethereum","pagination":{"page":1,"per_page":10},"token_address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","only_smart_money":false},"response":{"data":[{"action":"BUY","token_name":"USDC","token_amount":4302.946986,"token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","trader_address":"0x5de0e1e1ec3ec2e116d6d7f0561e8e699b4b69bc","block_timestamp":"2025-01-07T23:59:59","transaction_hash":"0x4946b457e7cfcab816da5b23373c37752849045a7aed7b6941c51228a6ed5a28","traded_token_name":"PIN","estimated_value_usd":4215.022728004488,"traded_token_amount":2003,"traded_token_address":"0x2e44f3f609ff5aa4819b323fd74690f07c3607c4","trader_address_label":"[0x5de0e1]","estimated_swap_price_usd":0.979566502148044},{"action":"SELL","token_name":"USDC","token_amount":899.026918,"token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","trader_address":"0xc6aa1ca4bc05f6b85ab65218998782d0c77e9765","block_timestamp":"2025-01-07T23:59:59","transaction_hash":"0x4aed238a493c9b4c35e42befc4ae1e06b16a4bef33333696e5e56e924a1de3ac","traded_token_name":"ETH","estimated_value_usd":965.5590486486176,"traded_token_amount":0.26516248190779035,"traded_token_address":"0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee","trader_address_label":"[0xc6aa1c]","estimated_swap_price_usd":1.0740046035513895},{"action":"SELL","token_name":"USDC","token_amount":195.191779,"token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","trader_address":"0x38ea91adfbf0738042414a25951419cd4a907b9d","block_timestamp":"2025-01-07T23:59:59","transaction_hash":"0x500db1e56a2263af462798db29fcf8dd8466ad457150d7b02072e243cb7cf003","traded_token_name":"ETH","estimated_value_usd":209.92553960841317,"traded_token_amount":0.057649894303518814,"traded_token_address":"0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee","trader_address_label":"[0x38ea91]","estimated_swap_price_usd":1.0754835100325264},{"action":"BUY","token_name":"USDC","token_amount":3052.268068,"token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","trader_address":"0x0091c05a50ef584f09c5c8b813a207198643788a","block_timestamp":"2025-01-07T23:59:59","transaction_hash":"0x518c60da5af7cdec599107c0f91b53e18a68f28dca7d0a8b665fb3d2a722dba8","traded_token_name":"GRAI","estimated_value_usd":3086.501154996992,"traded_token_amount":3130.752517,"traded_token_address":"0x15f74458ae0bfdaa1a96ca1aa779d715cc1eefe4","trader_address_label":"azorin.eth [0x0091c0]","estimated_swap_price_usd":1.0112156226892035},{"action":"BUY","token_name":"USDC","token_amount":146.842062,"token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","trader_address":"0x03351328843940bb13b014d3acf3debf9fa75525","block_timestamp":"2025-01-07T23:59:59","transaction_hash":"0x9788352090e1bd2f0e82ea386dff6c3b085ef0e3807e8d0e3d1f05e0c9ad0a20","traded_token_name":"MORPHO","estimated_value_usd":149.91574155938827,"traded_token_amount":45,"traded_token_address":"0x58d97b57bb95320f9a05dc918aef65434969c2b2","trader_address_label":"\"olos_is_my_ens\" on OpenSea [0x033513]","estimated_swap_price_usd":1.0209318741341855},{"action":"SELL","token_name":"USDC","token_amount":1000,"token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","trader_address":"0x63c16a7473c8e7ad40ceded3dbc8f2cd7cbb5eb6","block_timestamp":"2025-01-07T23:59:47","transaction_hash":"0x1e49a1a6b9699d000bb4cbf6985abe81adb94fcdb91117712be7b43c2d50affa","traded_token_name":"ETH","estimated_value_usd":1074.0094355428807,"traded_token_amount":0.2949452008341893,"traded_token_address":"0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee","trader_address_label":"[0x63c16a]","estimated_swap_price_usd":1.0740094355428806},{"action":"BUY","token_name":"USDC","token_amount":1523.873551,"token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","trader_address":"0xa69babef1ca67a37ffaf7a485dfff3382056e78c","block_timestamp":"2025-01-07T23:59:47","transaction_hash":"0x3683c81137a60919c6e5db95bdcd41c37c9be0c3aed1c19ba6ab1a8d70503e7f","traded_token_name":"AXL","estimated_value_usd":1676.426120786856,"traded_token_amount":2283.409185,"traded_token_address":"0x467719ad09025fcc6cf6f8311755809d45a5e5f3","trader_address_label":"🤖 SCP: 0xa69 [0xa69bab]","estimated_swap_price_usd":1.1001084175827762},{"action":"BUY","token_name":"USDC","token_amount":10832.262525,"token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","trader_address":"0x9d3c73222f2a4c0f9ced848d669393340db7d623","block_timestamp":"2025-01-07T23:59:47","transaction_hash":"0x89bcebc4e8acf24c027bce72b9ce4a7cf02c03f3bc629eb30be07692f051607b","traded_token_name":"SYRUPUSDC","estimated_value_usd":10830.10369853887,"traded_token_amount":10166.387017,"traded_token_address":"0x80ac24aa929eaf5013f6436cda2a7ba190f5cc0b","trader_address_label":"\"0x9d3\" on OpenSea [0x9d3c73]","estimated_swap_price_usd":0.9998007040120982},{"action":"BUY","token_name":"USDC","token_amount":4255.651235,"token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","trader_address":"0x49f1b03894f2fcdfd8dcf61d73d136417eaa998f","block_timestamp":"2025-01-07T23:59:47","transaction_hash":"0xa86e1603917dae75911078e3e7fade1f656036c3c239a8bd4d9c7a5b8bf55674","traded_token_name":"WETH","estimated_value_usd":4604.7063306945365,"traded_token_amount":1.265,"traded_token_address":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","trader_address_label":"[0x49f1b0]","estimated_swap_price_usd":1.0820215465082716},{"action":"BUY","token_name":"USDC","token_amount":4379.815717,"token_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","trader_address":"0x0b9625428fc3c8396478df7ef40cebcfa1aaa9ba","block_timestamp":"2025-01-07T23:59:47","transaction_hash":"0xbd9b5260ba933fb28d9d77e4ec1abae75ea6c097c9cd615edbd61a016b371ff4","traded_token_name":"CELL","estimated_value_usd":5001.497092060163,"traded_token_amount":5000,"traded_token_address":"0x26c8afbbfe1ebaca03c2bb082e69d0476bffe099","trader_address_label":"[0x0b9625]","estimated_swap_price_usd":1.1419423590465558}],"pagination":{"page":1,"per_page":10,"is_last_page":false}}},"exampleRequest":{"date":{"to":"2025-01-07T23:59:59Z","from":"2025-01-01T00:00:00Z"},"chain":"ethereum","pagination":{"page":1,"per_page":10},"token_address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","only_smart_money":false},"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_9RJ56Bw--mPV1SO8TZ4aB","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_7LpPPrSGV7Jd9l34-tYTy","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 DEX (decentralized exchange) trade data for a specific token using Nansen's Token God Mode analytics, with optional smart money filtering","exampleAgentPrompt":"Pull the Nansen Token God Mode DEX trades for token address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum for the past 7 days, and only show me trades made by smart money wallets.","exampleUseCases":null,"resultDescription":"A list of DEX trade records for the specified token, including swap details, wallet addresses, chains, and trade timestamps. When only_smart_money is enabled, results are filtered to trades made by wallets labeled as smart money by Nansen.","failureModes":["Invalid or unsupported token address returns empty results or 400 error","Unsupported chain value returns validation error","Date range too broad may be rejected or paginated","Missing required token_address field returns 400","Payment not included or insufficient returns 402 Payment Required","Rate limiting or quota exceeded returns 429"],"whenToPreferThis":"Use this endpoint when you need granular on-chain DEX trade data for a specific token and want Nansen's smart money labeling to filter or contextualize trades. Ideal for DeFi research, alpha hunting, or tracking institutional-grade wallet activity on decentralized exchanges. Prefer over generic on-chain data providers when smart money segmentation is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:41:37.896Z","isFirstParty":false}