{ "openapi": "3.0.1", "info": { "title": "Crypto Wallet Tracker API - Arkham Entity Labels and Transfers", "description": "Arkham Intel API in a dataset: who owns a crypto wallet (entity labels for exchanges, funds, whales), entity profiles, search, labelled transfers, counterparties, token balances and daily USD fund flows on Ethereum, Bitcoin, Solana, Tron, Base and more. Bring your own key.", "version": "0.1", "x-build-id": "dm5oQVySSaFdrTlc3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nabeelbaghoor~crypto-wallet-tracker-entity-labels-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nabeelbaghoor-crypto-wallet-tracker-entity-labels-api", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/nabeelbaghoor~crypto-wallet-tracker-entity-labels-api/runs": { "post": { "operationId": "runs-sync-nabeelbaghoor-crypto-wallet-tracker-entity-labels-api", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/nabeelbaghoor~crypto-wallet-tracker-entity-labels-api/run-sync": { "post": { "operationId": "run-sync-nabeelbaghoor-crypto-wallet-tracker-entity-labels-api", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "What to read", "enum": [ "addressLabels", "addressLabelsAllChains", "entityProfile", "search", "transfers", "addressCounterparties", "entityCounterparties", "addressBalances", "entityBalances", "addressFlow", "entityFlow" ], "type": "string", "description": "Address labels says who controls a wallet: the Arkham entity (exchange, fund, market maker, person) and the address label, on one chain or every chain. Entity profile reads an entity's type, links and tags. Search finds entity IDs, labelled addresses, tokens and ENS names for a name. Transfers reads enriched transfers with both sides labelled, filtered by entity, address, token, value and time. Counterparties lists who an address or entity sends to and receives from, by USD volume. Balances lists token holdings with USD value. Fund flow gives daily USD inflow, outflow and cumulative totals per chain.", "default": "addressLabels" }, "addresses": { "title": "Addresses", "type": "array", "description": "Blockchain addresses for the address modes: EVM, Bitcoin, Solana, Tron and the other supported chains. One per line; each is its own lookup.", "items": { "type": "string" } }, "entities": { "title": "Entities", "type": "array", "description": "Arkham entity IDs for the entity modes, such as binance, coinbase, wintermute, jump-trading or vitalik-buterin. IDs are lower case; the search mode finds the ID for a name. One per line.", "items": { "type": "string" } }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Search mode only. Names, addresses, ENS names or tokens to search for, one per line.", "items": { "type": "string" } }, "searchLimit": { "title": "Results per search category", "minimum": 1, "maximum": 50, "type": "integer", "description": "Search mode only. How many entities, labelled addresses, exchange entities, tokens and ENS names to return for each query (the API allows up to 50 per category).", "default": 10 }, "chains": { "title": "Chains", "type": "array", "description": "Limit transfers, counterparties, balances and fund flow to these chains. Leave empty for every supported chain. Address labels uses the first chain only (empty auto-detects the best chain).", "items": { "type": "string", "enum": [ "ethereum", "bitcoin", "solana", "tron", "bsc", "base", "arbitrum_one", "polygon", "optimism", "avalanche", "flare", "dogecoin", "zcash", "hyperevm", "hypercore", "robinhood" ], "enumTitles": [ "Ethereum", "Bitcoin", "Solana", "Tron", "BNB Smart Chain", "Base", "Arbitrum One", "Polygon", "Optimism", "Avalanche", "Flare", "Dogecoin", "Zcash", "HyperEVM", "HyperCore", "Robinhood Chain" ] } }, "baseFilter": { "title": "Transfers involving", "type": "array", "description": "Transfers only. Entities or addresses on either side, or filter forms such as type:cex, deposit:binance, prefix:0x28c6 or contract:true. Prefix with ! to exclude (type:cex and !binance is every exchange except Binance).", "items": { "type": "string" } }, "fromFilter": { "title": "Transfers from", "type": "array", "description": "Transfers only. Sending entities or addresses, or forms such as type:fund, deposit:coinbase or service:all. Prefix with ! to exclude.", "items": { "type": "string" } }, "toFilter": { "title": "Transfers to", "type": "array", "description": "Transfers only. Receiving entities or addresses, or forms such as type:cex, deposit:binance or service:binance. Prefix with ! to exclude.", "items": { "type": "string" } }, "tokens": { "title": "Tokens", "type": "array", "description": "Transfers and counterparties. Token IDs (CoinGecko pricing IDs such as tether, usd-coin, ethereum, bitcoin) or token contract addresses. Ticker symbols such as USDT match nothing. Prefix with ! to exclude.", "items": { "type": "string" } }, "direction": { "title": "Direction", "enum": [ "all", "in", "out", "self" ], "type": "string", "description": "Transfers and counterparties. Incoming or outgoing relative to the filtered entity or address. Counterparties accept incoming or outgoing only.", "default": "all" }, "timeWindow": { "title": "Time window", "enum": [ "any", "1h", "24h", "7d", "30d", "1M", "1y" ], "type": "string", "description": "Transfers and counterparties. A relative window ending now. Use either this or the dates below, not both.", "default": "any" }, "timeFrom": { "title": "Time from", "type": "string", "description": "Transfers and counterparties. Start of the range: a date (2026-01-31), an RFC 3339 time (2026-01-31T12:00:00Z) or a Unix timestamp. UTC." }, "timeTo": { "title": "Time to", "type": "string", "description": "Transfers and counterparties. End of the range, in the same formats as time from." }, "usdMin": { "title": "Minimum USD value", "minimum": 0, "type": "number", "description": "Transfers: minimum historical USD value per transfer. Counterparties: minimum aggregated USD volume per counterparty." }, "usdMax": { "title": "Maximum USD value", "minimum": 0, "type": "number", "description": "Transfers only. Maximum historical USD value per transfer." }, "sortBy": { "title": "Sort transfers by", "enum": [ "time", "value", "usd" ], "type": "string", "description": "Transfers only. Custom sorting needs the transfers.filter capability on your Arkham plan.", "default": "time" }, "sortDirection": { "title": "Sort direction", "enum": [ "desc", "asc" ], "type": "string", "description": "Transfers only.", "default": "desc" }, "counterpartyTags": { "title": "Counterparty tags", "type": "array", "description": "Counterparties only. Keep counterparties carrying these Arkham tags, such as whale or kol.", "items": { "type": "string" } }, "cheapBalances": { "title": "Faster entity balances", "type": "boolean", "description": "Entity balances only. Uses Arkham's faster balance query, which can be up to 24 hours behind.", "default": false }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "The most rows this run returns and charges for, across all lookups. Arkham bills transfers per row (2 credits each), so this also caps your Arkham credit spend.", "default": 100 }, "requestsPerMinute": { "title": "Requests per minute", "minimum": 1, "maximum": 6000, "type": "integer", "description": "Pacing. Heavy endpoints (transfers, search, flow, counterparties) are always spaced at least 1.1 seconds apart, as Arkham allows 1 request a second on them; a 429 is waited out and retried.", "default": 120 }, "apiKey": { "title": "API key", "type": "string", "description": "Your own Arkham Intel API key, from the API Keys tab of your Arkham API dashboard (arkm.com/api-dashboard). Stored as a secret and sent only in the API-Key header; it is never logged. You can instead set the DATA_API_KEY environment secret." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }