{"uid":"cap_Jxuo6mN9FQtLA2uDf7Q3f","slug":"arkham-x402-polymarket-activity-feed-0bd90821","name":"Arkham x402 - Polymarket Activity Feed","description":"Get Arkham Polymarket activity. $1.00 per call.","url":"https://api.arkm.com/x402/polymarket/activity","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Max results (default 50, max 500)."},"cursor":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Pass an empty value on the first request to use cursor pagination, then pass the returned nextCursor without…"},"maxUsd":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Maximum notional (size * price) in whole USD."},"minUsd":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Minimum notional (size * price) in whole USD."},"offset":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Offset for pagination (default 0)."},"sortBy":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Column to order by: time (default), size (outcome-token shares), price (cents-per-share), usd (notional)."},"actions":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Filter to one or more actions: buy, sell, split, merge, convert. Cannot be combined with eventType or directi…"},"endTime":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Unix timestamp in seconds for the end of the range (exclusive)."},"eventID":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Filter to all markets and outcomes in a Polymarket event."},"maxSize":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Maximum trade size in whole outcome-token shares."},"minSize":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Minimum trade size in whole outcome-token shares."},"maxPrice":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Maximum per-share price as a 0-1 fraction."},"minPrice":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Minimum per-share price as a 0-1 fraction."},"direction":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Narrow trades to one side: buy or sell. Only valid with eventType=trade (or no eventType)."},"entityIDs":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Filter to activity attributed to specific Arkham entity IDs. Combined with userAddresses using OR."},"eventType":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Filter by event class: trade, split, merge, or convert. Use direction to narrow trades to one side."},"sortOrder":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Sort direction: asc or desc (default)."},"startTime":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Unix timestamp in seconds for the start of the range (inclusive)."},"conditionID":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Filter to a single market condition ID (all of its outcome tokens)."},"userAddresses":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Filter to specific Polymarket trade addresses."},"fastPagination":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Fast pagination defaults to true. For offset pagination, set false to count matches up to 10,000. Cursor pagination alw…"},"tokenAddresses":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional. Filter to specific outcome token addresses. The conditionID, eventID, and tokenAddresses filters are intersec…"}}},"responseSchema":{"type":"json","example":{"events":[{"size":"5.833332","eventId":718313,"outcome":"Yes","imageUrl":"https://polymarket-upload.s3.us-east-2.amazonaws.com/uefa-conference-league-798904aed0.png","logIndex":390,"notional":"4.783333","question":"Will FCI Levadia win on 2026-07-21?","direction":"buy","eventType":"trade","conditionId":"0x20fc7c022c8594feaa4ad822b0a8758c9f01490a88bc939690883cafb44f9cec","userAddress":"0x0346afAe2603313d2BbeE96B628536c8CbE352a5","tokenAddress":"0x05d494e0f33fb6410b47565bb26fe5e3cbeb984524d4698fd8ae2243dccdc842","blockTimestamp":"2026-07-21T18:13:00Z","transactionHash":"0x4935ec7d03cc7e29a64b10180e06db1a04c8e40aec9471495527ed15f377df89"},{"size":"4","eventId":726168,"outcome":"Down","imageUrl":"https://polymarket-upload.s3.us-east-2.amazonaws.com/XRP-logo.png","logIndex":437,"notional":"0.08","question":"XRP Up or Down - July 21, 2:00PM-2:15PM ET","direction":"buy","eventType":"trade","conditionId":"0xa319d2bdf466dc979e26f0ff84dd793f10d7d8ff9525b1543a251e118aa59ee3","userAddress":"0x433668Ffa867f2Af45894E7ceA428fD42BD7E51c","tokenAddress":"0x75b0f37b95aaf358e3967c80cf86d1fa94fba45fde7f920c14469d2a75f6ca15","blockTimestamp":"2026-07-21T18:13:00Z","transactionHash":"0x0ad1b46cd4adbab7b9a1b79c163c1686a1340011e88fea2bf7a7e48562e2173e"}],"totalCount":51}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","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":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pexHVY35p0ESI_7Ec5xfj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves on-chain Polymarket trading activity events including trades, outcomes, and notional values for wallet addresses","exampleAgentPrompt":"Pull the latest Polymarket trading activity from Arkham — I want to see recent trades, what outcomes people are betting on, the trade sizes and notional values, and the wallet addresses behind the transactions.","exampleUseCases":[{"title":"Track whale bets on Polymarket","prompt":"Show me the most recent Polymarket trades from that big wallet 0x0346afAe2603313d2BbeE96B628536c8CbE352a5 — I want to know what outcomes they're buying, the trade sizes, and the notional dollar amounts."},{"title":"Monitor prediction market sentiment","prompt":"Pull Polymarket activity from Arkham and tell me which event outcomes people are currently buying vs selling and what the total count of trades looks like."},{"title":"Research specific Polymarket event trading","prompt":"Get me all Polymarket on-chain trades for the FCI Levadia match event — I need the wallet addresses, transaction hashes, and sizes of each trade so I can see who's participating."}],"resultDescription":"Returns a JSON object with an `events` array and a `totalCount`. Each event includes the trade size, event ID, outcome label, image URL, log index, notional USD value, question text, buy/sell direction, event type, condition ID, user wallet address, token address, block timestamp, and transaction hash.","failureModes":["Invalid or missing payment header returns 402 Payment Required","Malformed request body returns 400 Bad Request","Unknown condition ID or event ID returns empty events array","Rate limit or insufficient USDC balance returns payment error","Network timeout returns 504 if Polymarket on-chain data is slow to index"],"whenToPreferThis":"Choose this endpoint when you need structured on-chain Polymarket trade activity enriched with Arkham wallet intelligence metadata, including labeled wallet addresses and event context. Prefer this over raw blockchain RPC calls when you want human-readable outcome labels, event questions, and image URLs alongside transaction data, and when pay-per-request via x402 is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:02:45.419Z","isFirstParty":false}