{"uid":"cap_11NOQWsZ9QUqMx0PdEY5U","slug":"arkham-intelligence-tag-updates-3e6f6a84","name":"Arkham Intelligence Tag Updates","description":"Get Arkham tag definition updates. Provide at least one of: since, from. $6.00 per call.","url":"https://api.arkm.com/x402/intelligence/tags/updates","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":"End of time window (use with 'from', max 7-day window). Provide together with 'from' as an alternative to 'since'; mutu…"},"from":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Start of time window (use with 'to', max 7-day window). Provide together with 'to' as an alternative to 'since'; mutual…"},"limit":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Maximum results to return (1-1000, default 100)."},"since":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Returns changes since this time. Required unless both 'from' and 'to' are provided; mutually exclusive with 'from'/'to'."},"tagId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Tag IDs to filter by. Max 100."},"status":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter by change status."},"orderBy":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Sort order: 'time' (asc), 'addressCount', or 'entityCount' (desc). Default 'time'."},"category":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Tag categories to filter by. Max 100."},"pageToken":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Cursor token for pagination (from previous response). Accepted only with orderBy 'time'."}}},"responseSchema":{"type":"json","example":{"items":[{"id":"pengu-airdrop-recipient-cluster","rank":53,"status":"new","diff_ts":"2025-01-24T03:14:00Z","category":"Airdrop","diff_seq":1,"tag_name":"Pengu Airdrop Recipient Cluster","template":"Pengu Airdrop Recipient Cluster: %s","description":"Addresses who received the $PENGU airdrop","entity_count":5963,"address_count":336199},{"id":"brokerage","rank":5,"status":"updated","diff_ts":"2025-01-26T06:50:00Z","category":"Other","diff_seq":1,"tag_name":"Brokerage","template":"Brokerage","description":"Addresses associated with prime brokerage entities that offer a suite of services for institutional clients including lending, leveraged trade executions, OTC deals, and asset management","entity_count":0,"address_count":1}],"hasMore":true,"pageToken":"eyJkIjoiMjAyNS0xMi0xOVQwNTozMzowMFoiLCJxIjoyOX0=","latest_diff_ts":"2025-12-19T05:33:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"6","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":"$6/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"6","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"6","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_La61jyAXtfnk5uO8yS1KH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"6","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a paginated feed of recently created or updated blockchain address tags from Arkham's wallet intelligence database.","exampleAgentPrompt":"Pull the latest Arkham tag updates — I want to see any newly added or changed address classifications, including airdrop recipient clusters or brokerage tags, and page through them if there are more results.","exampleUseCases":[{"title":"Monitor new airdrop cluster tags","prompt":"Check Arkham for any new airdrop recipient cluster tags that have been added recently — I want to know which token airdrops have been classified and how many addresses are in each cluster."},{"title":"Track institutional brokerage address updates","prompt":"Fetch the latest Arkham tag updates and flag anything in the brokerage or institutional category that's been newly added or changed so I can update my compliance watchlist."},{"title":"Build a live on-chain intelligence feed","prompt":"Give me a paginated feed of all recent Arkham tag updates, starting from the beginning, so I can sync the latest wallet classifications into my internal database."}],"resultDescription":"Returns a JSON object containing a list of tag update items, each with fields including tag ID, name, category, description, rank, status (new or updated), diff timestamp, entity count, and address count. Also includes a hasMore boolean, a pageToken for pagination, and a latest_diff_ts timestamp indicating the most recent update seen.","failureModes":["Invalid or expired page token returns an error or restarts pagination","Payment failure via x402 protocol results in 402 response and no data returned","Malformed POST body may result in 400 Bad Request","Rate limiting if too many requests are made in rapid succession","Empty result set if no tags have been updated since the last poll"],"whenToPreferThis":"Use this endpoint when you need to stay current with Arkham's evolving on-chain address classification system — specifically to detect newly created tags or updates to existing ones. Prefer this over static address lookup endpoints when your goal is change detection or syncing a local copy of Arkham's tag database. It is the right choice for building intelligence pipelines that react to new entity classifications like airdrop clusters, exchange wallets, or brokerage addresses.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:55:39.993Z","isFirstParty":false}