{"uid":"cap_YR5GoOykysD1VzWCIEwiq","slug":"market-intelligence-api-token-dex-trade-flow-intelligence-6c5e973e","name":"Market Intelligence API – Token DEX Trade Flow Intelligence","description":"Token trade flow and DEX volume by contract address (Base by default; chain=ethereum, arbitrum, optimism or polygon): last-hour swaps, buy and sell volume in USD, buy pressure, price change, largest trade, trader concentration and a verdict (ACCUMULATION, DISTRIBUTION, BALANCED, ILLIQUID_OR_INACTIVE). Read live from the chain; repeat requests within 45 s share one read.","url":"https://api.marketintelligenceapi.com/api/v1/intelligence/token/:address?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","examples":["0x940181a94a35a4569e4529a3cdfb74e38fd98631"],"description":"Any ERC-20 contract address (0x...) on the chain given by ?chain (base, ethereum, arbitrum, optimism or polygon)."}},"additionalProperties":false},"queryParams":{"type":"object","properties":{"chain":{"enum":["base","ethereum","arbitrum","optimism","polygon"],"type":"string","default":"base","description":"Chain the token lives on: base, ethereum, arbitrum, optimism or polygon. Not the payment network: payment networks are in x-payment-info.networks."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"description":"Example JSON response returned by this endpoint"}},"additionalProperties":true}},"additionalProperties":false},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3ZepPInt_wS0irLPEnnw6","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":"Returns live on-chain DEX trade flow analytics for a given token contract address (Base, Arbitrum, or Optimism), including buy/sell volumes, price change, trader concentration, and a market verdict for the last hour.","exampleAgentPrompt":"What's the live on-chain trade flow for token contract 0x4200000000000000000000000000000000000006 on Base — is it being accumulated or distributed right now, and what's the buy pressure?","exampleUseCases":[{"title":"Pre-trade token market check","prompt":"Before I buy into this token, can you pull the last hour of DEX trade flow for contract 0xabc123... on Base and tell me if it's being accumulated or distributed and what the buy pressure looks like?"},{"title":"Arbitrum token whale activity scan","prompt":"Check whether there's any unusual trader concentration or large single trades happening for contract 0xdef456... on Arbitrum right now — I want to know if whales are moving it."},{"title":"Illiquid token viability check","prompt":"Is contract 0x789xyz... on Optimism even actively traded? Give me the on-chain swap count, volume, and whether it's coming back as ILLIQUID_OR_INACTIVE or something else."}],"resultDescription":"A JSON object containing: number of swaps, buy and sell volume in USD, buy pressure ratio, percentage price change, size of the largest trade, trader concentration metric, supported chain, and a categorical market verdict (ACCUMULATION, DISTRIBUTION, BALANCED, or ILLIQUID_OR_INACTIVE) for the past hour of on-chain DEX activity.","failureModes":["Invalid or non-existent contract address returns an error or empty result","Unsupported chain value (not base, arbitrum, or optimism) returns a validation error","Token with no trades in the last hour returns ILLIQUID_OR_INACTIVE verdict","Rate limiting if too many unique addresses are queried rapidly; requests within 45s share a cached read","Network or RPC read failure may cause transient errors"],"whenToPreferThis":"Choose this endpoint when you need real-time, on-chain DEX trade signal data for a specific token on Base, Arbitrum, or Optimism — particularly when you want a structured verdict (ACCUMULATION, DISTRIBUTION, BALANCED, ILLIQUID_OR_INACTIVE) rather than raw price feeds. It is ideal for pre-trade due diligence, detecting whale activity or trader concentration, and assessing whether a token is liquid enough to trade. It is not suitable for off-chain CEX price data, historical data beyond one hour, or token networks outside Base, Arbitrum, and Optimism.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:36:43.580Z","isFirstParty":false,"canonicalSlug":"market-intelligence-api-token-dex-trade-flow-intelligence-6c5e973e"}