{"uid":"cap_F747abx1utYOaQ7lyDjOK","slug":"arkham-x402-swaps-76b0078d","name":"Arkham x402 Swaps","description":"Get Arkham DEX swap transactions. Priced per row: $0.40 × limit (default 20, max 1649); pass the smallest useful limit.","url":"https://api.arkm.com/x402/swaps","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"to":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter to swaps where the base bought one of these tokens (token addresses or token IDs). Combine with 'from' for a spe…"},"base":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter by specific entity or address involved in the swap. Omitting it returns an empty list."},"flow":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Swap direction relative to the base address. Valid values: 'in' (receiving token1), 'out' (sending token0), or 'all'. D…"},"from":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter to swaps where the base sold one of these tokens (token addresses or token IDs). Combine with 'to' for a specifi…"},"limit":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Maximum number of results to return. Default: 20. Max: 1649."},"chains":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Chains to filter by, as a single comma-separated value (e.g. 'ethereum,solana'). If omitted, returns data across all su…"},"offset":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Pagination offset. offset + limit must not exceed 10000."},"tokens":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"List of token addresses or token IDs that appear as either token0 or token1."},"usdGte":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Minimum historical USD value."},"usdLte":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Maximum historical USD value."},"senders":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter by the transaction parties that initiated the swap (sender addresses or entities). Distinct from 'from', which f…"},"sortDir":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Sort direction: 'asc' (ascending) or 'desc' (descending). Defaults to 'desc'."},"sortKey":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Field by which to sort the results. One of: time, usd."},"timeGte":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter swaps at or after this time (unix ms, unix seconds, RFC3339, or YYYY-MM-DD)."},"timeLte":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter swaps at or before this time (unix ms, unix seconds, RFC3339, or YYYY-MM-DD)."},"timeLast":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Time range filter using relative durations (e.g. 24h, 7d). Cannot be combined with timeGte/timeLte."},"protocols":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter by protocol/DEX addresses or entity IDs."},"receivers":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter by the transaction parties that received the swap output (receiver addresses or entities). Distinct from 'to', w…"},"value0Gte":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Minimum token0 amount (decimal-adjusted; matched on absolute value)."},"value0Lte":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Maximum token0 amount (decimal-adjusted; matched on absolute value)."},"value1Gte":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Minimum token1 amount (decimal-adjusted; matched on absolute value)."},"value1Lte":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Maximum token1 amount (decimal-adjusted; matched on absolute value)."},"counterparties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"List of addresses or entities to treat strictly as counterparties."}}},"responseSchema":{"type":"json","example":{"count":10000,"swaps":[{"id":"0xb62ab136f09349dd1d2f7c97e830a161c003e60509ff27cdf1f1769d18b963a8_2","chain":"ethereum","valid":true,"sender":{"chain":"ethereum","address":"0x51C72848c68a965f66FA7a88855F9f7784502a7F","contract":true,"arkhamLabel":{"name":"Market Maker","address":"0x51C72848c68a965f66FA7a88855F9f7784502a7F","chainType":"evm"},"arkhamEntity":{"id":"wintermute","name":"Wintermute","note":"","type":"fund","service":null,"twitter":"https://twitter.com/wintermute_t","website":"https://www.wintermute.com/","linkedin":"https://www.linkedin.com/company/wintermute-trading","crunchbase":"https://www.crunchbase.com/organization/wintermute-trading"},"isUserAddress":false},"token0":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","token1":"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2","receiver":{"chain":"ethereum","address":"0x51C72848c68a965f66FA7a88855F9f7784502a7F","contract":true,"arkhamLabel":{"name":"Market Maker","address":"0x51C72848c68a965f66FA7a88855F9f7784502a7F","chainType":"evm"},"arkhamEntity":{"id":"wintermute","name":"Wintermute","note":"","type":"fund","service":null,"twitter":"https://twitter.com/wintermute_t","website":"https://www.wintermute.com/","linkedin":"https://www.linkedin.com/company/wintermute-trading","crunchbase":"https://www.crunchbase.com/organization/wintermute-trading"},"isUserAddress":false},"token0Id":"usd-coin","token1Id":"weth","blockHash":"0x6e9f88a716532f88ca3e3154a4988dc82405fe7774bb2db1965880c02833a051","token0Name":"USD Coin","token1Name":"Wrapped Ether","unitValue0":-9128487.881334,"unitValue1":4263.136684788042,"blockNumber":24643153,"token0Symbol":"USDC","token1Symbol":"WETH","historicalUSD":9128487.881334,"blockTimestamp":"2026-03-12T18:23:47Z","token0Decimals":6,"token1Decimals":18,"contractAddress":{"chain":"ethereum","address":"0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640","contract":true,"arkhamLabel":{"name":"USDC 3","address":"0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640","chainType":"evm"},"arkhamEntity":{"id":"uniswap","name":"Uniswap","note":"","type":"dex","service":null,"twitter":"https://twitter.com/Uniswap","website":"https://uniswap.org","linkedin":"https://www.linkedin.com/company/uniswaporg","crunchbase":"https://www.crunchbase.com/organization/uniswap-labs"},"isUserAddress":false},"contractEntityId":"uniswap"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"8","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":"$8/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"8","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"8","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Gf14qLavdMa4Z7hWn_zK9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"8","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves on-chain token swap transactions with Arkham entity/label intelligence, including sender/receiver wallet attribution and USD values.","exampleAgentPrompt":"Pull the latest swaps involving Wintermute on Ethereum from Arkham — I want to see which token pairs they've been trading, the USD values, and sender/receiver labels.","exampleUseCases":[{"title":"Track large market maker DEX activity","prompt":"Show me all the recent on-chain swaps by Wintermute on Ethereum, including the token pairs, trade sizes in USD, and which smart contracts they used."},{"title":"Monitor specific token pair swap flow","prompt":"Get me the latest USDC/WETH swap transactions on Ethereum from Arkham — I want to see who the senders and receivers are and whether they're labeled entities."},{"title":"Investigate whale swap behavior pre-event","prompt":"Pull the on-chain swap history for wallet 0x51C72848c68a965f66FA7a88855F9f7784502a7F on Ethereum and show me the Arkham entity attribution and USD values for each trade."}],"resultDescription":"Returns a list of swap transactions with full Arkham intelligence enrichment: swap ID, chain, token pair (addresses, symbols, decimals), sender and receiver wallet info including Arkham labels and entity profiles (name, type, social links), USD value at time of swap, block number, block hash, and timestamp. Also returns a total count of matching swaps.","failureModes":["Insufficient USDC balance for x402 payment results in 402 Payment Required","Invalid or unsupported chain identifier returns 400 Bad Request","Wallet address not found in Arkham database returns empty swaps array","Rate limiting or quota exceeded returns 429 Too Many Requests","Malformed POST body or missing required filters returns 400 Bad Request","Timestamp or block range too broad may return truncated results"],"whenToPreferThis":"Use this endpoint when you need on-chain DEX swap data enriched with Arkham's proprietary entity and label intelligence — particularly when identifying which known funds, market makers, or labeled wallets are behind specific swaps. Prefer this over raw blockchain RPC calls or generic DEX APIs when entity attribution is important, or when you need USD-denominated swap values alongside wallet identity context.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:47:29.071Z","isFirstParty":false}