{"uid":"cap_wgpl0j-klHamh_3U50BXK","slug":"arkham-intelligence-address-tag-updates-7199fdf9","name":"Arkham Intelligence Address Tag Updates","description":"Get Arkham address-tag association updates. Provide at least one of: since, from. $20.00 per call.","url":"https://api.arkm.com/x402/intelligence/address-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…"},"chain":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Blockchain networks to filter by."},"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. For address tags only 'new', 'deleted', and 'all' are valid (no 'updated')."},"address":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Blockchain addresses to filter by. Max 100."},"orderBy":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Sort order: 'time' (asc) or 'rank' (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."},"entityId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Entity IDs 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'."},"tagParams":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Filter by tag parameters (JSON string matching tag-specific params)."}}},"responseSchema":{"type":"json","example":{"items":[{"rank":140,"chain":"arbitrum_one","status":"new","tag_id":"arbitrum-one-first-funder","address":"0x000000000000000000000000000000000000800A","diff_ts":"2025-01-01T02:52:00Z","category":"Other","diff_seq":1,"tag_name":"Arbitrum One First Funder","template":"Arbitrum One First Funder: %s","tag_params":"0x35e14525280193cb71e8204cABafCf10F7e5Dc25"},{"rank":540,"chain":"arbitrum_one","label":"494119.eth","status":"deleted","tag_id":"early-token-holder","address":"0x000072ba5D51098b904A927ddE54C22aD480B5B5","diff_ts":"2025-01-01T02:52:00Z","category":"Other","diff_seq":13,"tag_name":"Early Token Holder","template":"Early %s Holder","entity_id":"0xdyno","tag_params":"GEM","entity_name":"@0xDyno","entity_type":"individual"}],"hasMore":true,"pageToken":"eyJkIjoiMjAyNS0wMS0wMVQwMjo1MjowMFoiLCJxIjoxMDB9","latest_diff_ts":"2025-01-01T02:52:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"20","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":"$20/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"20","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"20","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_TKeoky0PNyeMbW11gcCQU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"20","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a paginated list of changes (new/deleted) to on-chain address tags across supported blockchains, including tag names, categories, and associated entity metadata.","exampleAgentPrompt":"Pull the latest address tag updates from Arkham for Arbitrum One — I want to see which wallet addresses have been newly labeled or had labels removed, starting from the most recent changes.","exampleUseCases":[{"title":"Monitor newly identified DeFi wallets","prompt":"Check Arkham for any new address tags added on Arbitrum One in the last day — I want to know which wallets just got labeled and what category they fall into."},{"title":"Audit entity label removals","prompt":"Pull the Arkham tag update feed and show me any wallet addresses that had labels deleted recently, including the entity name and tag type that was removed."},{"title":"Enrich on-chain watchlist with fresh tags","prompt":"I have a watchlist of crypto addresses — can you check Arkham's latest tag updates to see if any of them have been newly identified or re-labeled with entity information?"}],"resultDescription":"A paginated JSON response containing a list of address tag change events, each with the blockchain address, chain, tag ID, tag name, tag category, status (new or deleted), timestamp of the change, optional entity name/type, and a pageToken for fetching the next page. A `hasMore` flag indicates whether additional pages exist.","failureModes":["Invalid or expired page token returns an error or resets pagination","Unsupported chain identifier results in empty results or 400 error","Missing or invalid x402 payment header causes 402 Payment Required response","Rate limiting or payment failure interrupts paginated streaming","No updates available for the requested time window returns empty items array"],"whenToPreferThis":"Use this endpoint when you need to track incremental changes to Arkham's address intelligence database — specifically which wallets have been newly tagged or had tags removed — rather than querying static tags for a known address. Prefer this for building surveillance pipelines, enriching watchlists with fresh labels, or detecting newly identified entities across supported blockchains.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:47:48.734Z","isFirstParty":false}