Skip to content
/
Bulk upload addresses for...

Arkham Intel API (1.0.0)

Arkham Intelligence official API documentation

The Arkham API provides direct query access to Ultra, our proprietary AI-powered algorithmic address matching engine, enabling sophisticated users to customize data flows and integrate them into their existing systems.

Through the API, users can write custom queries to access a list of Arkham labels, as well as transaction logs and historical balance data for addresses and entities.

Institutions that onboard to the Arkham Exchange automatically qualify for access to this API.

The deprecated API documentation is available here in multiple languages; however, please note that it is no longer being updated.

⚠️ IMPORTANT: API-Key

All API requests MUST include a valid API-Key header. Requests without this header will be rejected with an unauthorized response.

To authenticate with Arkham's API, simply provide a valid API-Key in the header of your request. To apply for API access to our platform, visit: https://info.arkm.com/api-platform.

Endpoints

Our root URL is https://api.arkm.com.

Rate limits

Our API uses tier-based rate limits with different limits for different endpoints:

Standard Rate Limits

For the Basic API tier, most endpoints allow up to 20 requests per second with a small additional burst allowance for occasional spikes beyond that threshold.

Heavy Endpoints Rate Limits

Some resource-intensive endpoints have lower rate limits of 1 request per second:

  • /transfers
  • /swaps
  • /counterparties/address/{address}
  • /counterparties/entity/{entity}
  • /token/top_flow/{id}
  • /token/top_flow/{chain}/{address}
  • /token/volume/{id}
  • /token/volume/{chain}/{address}
  • /transfers/histogram

Note: These heavy endpoints are computationally intensive and query large amounts of data, hence the stricter rate limits to ensure platform stability.

If you are consistently hitting the default rate limit we have set for our API you can apply for a rate limit increase here.

Security and Privacy

All data on our platform—including your private labels—is stored securely, using state-of-the-art encryption both at rest and in transit, along with strict access controls to ensure your information remains confidential. For further details on our security and privacy measures, please refer to our Privacy Policy.

Download OpenAPI description
openapi.json
openapi.yaml
Overview
License
Prop
Languages
Servers
Mock server
https://docs.intel.arkm.com/_mock/openapi/
Production server
https://api.arkm.com/

Health

API Health check

Operations

Chains

View full list of supported blockchains.

Operations

Transfers

Provides endpoints for retrieving blockchain transfer and swap activity. These include detailed transfer lists, aggregated histograms for analyzing transfer trends over time, and DEX swap data, all filterable by various query parameters.

Operations

Transaction

Provides an endpoint for retrieving detailed information about a specific blockchain transaction using its hash. The response includes metadata such as block number, timestamp, sender and recipient addresses, gas usage, fees, value in native units and USD, and token details.

Operations

Token exchange movements

Provides an endpoint for analyzing token activity across centralized and decentralized exchanges. This includes ranking tokens by volume, inflows, outflows, netflows, and other metrics over customizable time intervals, with support for filtering by chain, market cap, and specific tokens.

Operations

User entities

Provides endpoints for managing custom entities created by an authenticated user. Entities can be retrieved in bulk or individually, with support for including associated blockchain addresses.

Operations

Entity bulk update

Provides endpoints for updating custom entities in bulk. Entities can be fully overwritten (replacing details and address sets) or incrementally updated by adding new addresses without removing existing ones.

Operations

Overwrite an entity (replace addresses)

Request

Updates an entity by overwriting its details and full address set. The complete JSON input must include the updated entity fields plus a multi‑chain addresses mapping. The addresses object is keyed by blockchain type (for example, evm, bitcoin, solana, etc.) and each value is an array of address strings.

Important: Any existing addresses not present in the payload will be removed. Use /user/entities/only_add/{id} if you want to keep existing addresses and only append new ones.

Example Input Explanation:

  • name / note: Optional text fields. name is limited to 256 characters; note to 1024 characters.
  • addresses: Map of chain to array of addresses.
  • Bulk updates allow up to 100 total addresses per entity. Ensure addresses are valid and formatted correctly.
Security
ApiKeyAuth
Path
idstringrequired

Unique identifier of the entity to update. You can grab it from your url https://intel.arkm.com/explorer/entity/{entityId}

Bodyapplication/jsonrequired
namestringrequired
Example: "Example Name"
notestring
Example: "Updated note"
idstringrequired
Example: "exampleID"
typestring or null
Example: null
serviceboolean or null
Example: null
addressesobject
Example: {"evm":["0xC17eF7e2689DFf7D269Ae2C22f857AcD60B42187","0x7dCC00d0Da47e6982672CB1C2481A6943737af45"],"bitcoin":["bc1qd7m42p9w8djak3qeme06stw7ach7hewa88rd6q0rgegw3mdlpl5s5wje56"],"solana":["H6r6ShBfuoVYCCb8ZJANFYfR4y1EXr4vTLYPKbmHGxtv"],"tron":["TLBsPRBS6WeB6DyzKSNhKXHxaWESeoK44g"]}
ownerUIDstring
Example: "exampleOwnerId"
linkShareableboolean
Example: false
createdAtstring(date-time)
Example: "2019-07-12T11:18:33Z"
updatedAtstring(date-time)
Example: "2019-07-12T12:47:55Z"
curl -i -X PUT \
  'https://docs.intel.arkm.com/_mock/openapi/user/entities/{id}' \
  -H 'API-Key: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "exampleID",
    "name": "Example Entity",
    "note": "Updated note for my entity.",
    "addresses": {
      "evm": [
        "0xC17eF7e2689DFf7D269Ae2C22f857AcD60B42187",
        "0x7dCC00d0Da47e6982672CB1C2481A6943737af45"
      ],
      "bitcoin": [
        "bc1qd7m42p9w8djak3qeme06stw7ach7hewa88rd6q0rgegw3mdlpl5s5wje56"
      ],
      "solana": [
        "H6r6ShBfuoVYCCb8ZJANFYfR4y1EXr4vTLYPKbmHGxtv"
      ],
      "tron": [
        "TLBsPRBS6WeB6DyzKSNhKXHxaWESeoK44g"
      ]
    }
  }'

Responses

Successful update of the entity. Returns the updated entity.

Bodyapplication/json
One of:
idstring
Example: "vitalik-buterin"
namestring
Example: "Vitalik Buterin"
notestring
Example: ""
addressesobject or null
Example: null
customizedboolean
Example: false
typestring or null
Example: "individual"
serviceboolean or null
Example: null
ownerUIDstring or null
Example: "if0jX2ggQzRlZnKYieI6uhLb07W1"
websitestring
Example: "https://vitalik.eth.limo/"
twitterstring
Example: "https://x.com/vitalikbuterin"
crunchbasestring
Example: "https://www.crunchbase.com/person/vitalik-buterin"
linkedinstring
Example: "https://ca.linkedin.com/in/vitalik-buterin-267a7450"
instagramstring
Example: "https://www.instagram.com/vitalik.eth.official"
customImageSlugstring
Example: "https://static.arkhamintelligence.com/entities/vitalik-buterin.png"
populatedTagsArray of objects(PopulatedTag)
linkShareableboolean
Example: true
createdAtstring(date-time)
Example: "2019-07-12T11:18:33Z"
updatedAtstring(date-time)
Example: "2019-07-12T12:47:55Z"
Response
application/json
{
  "id": "vitalik-buterin",
  "name": "Vitalik Buterin",
  "note": "",
  "addresses": null,
  "customized": false,
  "type": "individual",
  "service": null,
  "ownerUID": "if0jX2ggQzRlZnKYieI6uhLb07W1",
  "website": "https://vitalik.eth.limo/",
  "twitter": "https://x.com/vitalikbuterin",
  "crunchbase": "https://www.crunchbase.com/person/vitalik-buterin",
  "linkedin": "https://ca.linkedin.com/in/vitalik-buterin-267a7450",
  "instagram": "https://www.instagram.com/vitalik.eth.official",
  "customImageSlug": "https://static.arkhamintelligence.com/entities/vitalik-buterin.png",
  "populatedTags": [
    { … }
  ],
  "linkShareable": true,
  "createdAt": "2019-07-12T11:18:33Z",
  "updatedAt": "2019-07-12T12:47:55Z"
}

Bulk upload addresses for an entity (only add new addresses)

Request

Updates an entity by bulk uploading addresses. The full JSON input must include the updated entity details along with a multi-chain addresses mapping. The addresses object is keyed by blockchain type (for example, evm, bitcoin, solana, etc.) and each value is an array of address strings.

Example Input Explanation:

  • addresses: A map where each key is a chain identifier and the value is an array of valid hexadecimal addresses (or formatted address strings for non-EVM chains).
  • Use the same JSON format regardless of whether the entity is a user entity or an Arkham entity.
  • Bulk uploads allow up to 100 total addresses per entity. Make sure addresses are valid and formatted correctly.
Security
ApiKeyAuth
Path
idstringrequired

Unique identifier of the entity to update. You can grab it from your url https://intel.arkm.com/explorer/entity/{entityId}

Bodyapplication/jsonrequired
namestringrequired
Example: "Example Name"
notestring
Example: "Updated note"
idstringrequired
Example: "exampleID"
typestring or null
Example: null
serviceboolean or null
Example: null
addressesobject
Example: {"evm":["0xC17eF7e2689DFf7D269Ae2C22f857AcD60B42187","0x7dCC00d0Da47e6982672CB1C2481A6943737af45"],"bitcoin":["bc1qd7m42p9w8djak3qeme06stw7ach7hewa88rd6q0rgegw3mdlpl5s5wje56"],"solana":["H6r6ShBfuoVYCCb8ZJANFYfR4y1EXr4vTLYPKbmHGxtv"],"tron":["TLBsPRBS6WeB6DyzKSNhKXHxaWESeoK44g"]}
ownerUIDstring
Example: "exampleOwnerId"
linkShareableboolean
Example: false
createdAtstring(date-time)
Example: "2019-07-12T11:18:33Z"
updatedAtstring(date-time)
Example: "2019-07-12T12:47:55Z"
curl -i -X PUT \
  'https://docs.intel.arkm.com/_mock/openapi/user/entities/only_add/{id}' \
  -H 'API-Key: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "exampleID",
    "name": "Example Entity",
    "note": "Updated note for my entity.",
    "addresses": {
      "evm": [
        "0xC17eF7e2689DFf7D269Ae2C22f857AcD60B42187",
        "0x7dCC00d0Da47e6982672CB1C2481A6943737af45",
        "0x36e7C3dd82A56192cF24f326361105D28b426d64"
      ],
      "bitcoin": [
        "bc1qd7m42p9w8djak3qeme06stw7ach7hewa88rd6q0rgegw3mdlpl5s5wje56"
      ],
      "solana": [
        "H6r6ShBfuoVYCCb8ZJANFYfR4y1EXr4vTLYPKbmHGxtv"
      ],
      "tron": [
        "TLBsPRBS6WeB6DyzKSNhKXHxaWESeoK44g"
      ],
      "dogecoin": [
        "D5mBhUmsSKTLMNzBCQcqhF4ZVg7RLtJtCS"
      ],
      "ton": [
        "0:412451AE5C7AE4A427DA58D02BFE6D3A3DB4602C4C2A87021B60ACA974189577"
      ]
    }
  }'

Responses

Successful update of the entity. Returns the updated entity.

Bodyapplication/json
One of:
idstring
Example: "vitalik-buterin"
namestring
Example: "Vitalik Buterin"
notestring
Example: ""
addressesobject or null
Example: null
customizedboolean
Example: false
typestring or null
Example: "individual"
serviceboolean or null
Example: null
ownerUIDstring or null
Example: "if0jX2ggQzRlZnKYieI6uhLb07W1"
websitestring
Example: "https://vitalik.eth.limo/"
twitterstring
Example: "https://x.com/vitalikbuterin"
crunchbasestring
Example: "https://www.crunchbase.com/person/vitalik-buterin"
linkedinstring
Example: "https://ca.linkedin.com/in/vitalik-buterin-267a7450"
instagramstring
Example: "https://www.instagram.com/vitalik.eth.official"
customImageSlugstring
Example: "https://static.arkhamintelligence.com/entities/vitalik-buterin.png"
populatedTagsArray of objects(PopulatedTag)
linkShareableboolean
Example: true
createdAtstring(date-time)
Example: "2019-07-12T11:18:33Z"
updatedAtstring(date-time)
Example: "2019-07-12T12:47:55Z"
Response
application/json
{
  "id": "vitalik-buterin",
  "name": "Vitalik Buterin",
  "note": "",
  "addresses": null,
  "customized": false,
  "type": "individual",
  "service": null,
  "ownerUID": "if0jX2ggQzRlZnKYieI6uhLb07W1",
  "website": "https://vitalik.eth.limo/",
  "twitter": "https://x.com/vitalikbuterin",
  "crunchbase": "https://www.crunchbase.com/person/vitalik-buterin",
  "linkedin": "https://ca.linkedin.com/in/vitalik-buterin-267a7450",
  "instagram": "https://www.instagram.com/vitalik.eth.official",
  "customImageSlug": "https://static.arkhamintelligence.com/entities/vitalik-buterin.png",
  "populatedTags": [
    { … }
  ],
  "linkShareable": true,
  "createdAt": "2019-07-12T11:18:33Z",
  "updatedAt": "2019-07-12T12:47:55Z"
}

Intelligence

Provides AI-powered intelligence endpoints for analyzing blockchain addresses, entities, contracts, and tokens. These endpoints return enriched insights such as tagging data, entity associations, predicted addresses, contract metadata, and token information across multiple chains.

Operations

History

Provides endpoints for retrieving historical analytics on blockchain entities and addresses. Returns time-series USD value snapshots to help analyze changes over time.

Operations

Portfolio

Provides endpoints for managing and tracking entity and address portfolios. Includes historical snapshots, daily time-series data, and cross-chain portfolio analytics.

Operations

Token

Provides endpoints for retrieving token-related information, including holders, flows, volumes, trending tokens, and balances across chains. These endpoints allow analysis of token distribution, trading activity, and ownership at both entity and address levels.

Operations

Market Data

Provides an endpoint for accessing market data and analytics, including indices and metrics that track token and altcoin performance relative to the broader market.

Operations

ARKM

Provides endpoints related to the ARKM token and Arkham Exchange tokens, including supply information and token listings.

Operations

Networks

Provides endpoints for monitoring blockchain networks and retrieving chain-specific historical data, including current status and historical quotes.

Operations

Balances

Provides endpoints for tracking and retrieving token balances for blockchain addresses and entities, with optional filtering by chain.

Operations

Loans

Provides endpoints for tracking loan and borrow positions on-chain, including supplied, borrowed, and outstanding assets for addresses and entities.

Operations

Counterparties

Provides endpoints for analyzing counterparty activity, aggregating top counterparties by volume for addresses and entities. Supports filtering by transfer direction, chain, token, time range, and transaction value.

Operations

Labels

Provides endpoints for managing user-defined labels, including creating, retrieving, updating, and deleting labels associated with blockchain addresses.

Operations

Flow

Provides endpoints for analyzing historical USD flows for addresses and entities across supported chains, including inflows, outflows, and running totals over time.

Operations