Skip to content

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

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

Get counterparties for an address

Request

Returns aggregated info about top counterparties by volume (in/out).

Rate Limit: This endpoint has a stricter rate limit of 1 request per second.

Filter parameters:

  • flow: Direction of the transfer. Valid values are "in", "out", or "either".
  • limit: Maximum number of results to return.
  • chains: Comma-separated list of chains (e.g. "ethereum,bsc").
  • tokens: Comma-separated list of token addresses or token IDs. E.g. "ethereum", "usd-coin", or "0x...tokenAddress".
  • timeLast: Time range filter using relative durations (e.g. "24h", "7d", "30d"). Cannot be used with timeGte/timeLte.
  • timeGte/timeLte: Filter from/to a specific timestamp in milliseconds. Cannot be used with 'timeLast' parameter.
  • valueGte/valueLte: Numeric filters on the raw token amount (on-chain units).
  • usdGte/usdLte: Numeric filters on the historical USD value.
Security
ApiKeyAuth
Path
addressstringrequired

The address to get counterparties for.

Query
flowstring

Transfer direction: "in" for incoming, "out" for outgoing, "either" for both directions.

Enum"in""out""either"
limitinteger

Maximum number of counterparties to return (between 1 and 1000).

Default 100
chainsstring

Comma-separated list of chains. For example: "ethereum,bsc".

tokensstring

Comma-separated list of token addresses or token IDs. E.g. "ethereum", "usd-coin", or "0x...tokenAddress".

timeLaststring

Time range filter using relative durations. Examples: "24h", "7d", "30d". Cannot be used with timeGte/timeLte.

timeGtestring

Time range filter (from) in milliseconds (e.g. 1696630274000). Cannot be used with 'timeLast' parameter.

timeLtestring

Time range filter (to) in milliseconds (e.g. 1696716674000). Cannot be used with 'timeLast' parameter.

valueGtenumber

Minimum raw token value (on-chain units).

valueLtenumber

Maximum raw token value (on-chain units).

usdGtenumber

Minimum historical USD value.

usdLtenumber

Maximum historical USD value.

curl -i -X GET \
  'https://docs.intel.arkm.com/_mock/openapi/counterparties/address/{address}?flow=in&limit=100&chains=string&tokens=string&timeLast=string&timeGte=string&timeLte=string&valueGte=0&valueLte=0&usdGte=0&usdLte=0' \
  -H 'API-Key: YOUR_API_KEY_HERE'

Responses

Counterparty data

Bodyapplication/json
property name*Array of objects(Counterparty)additional property
Response
application/json
{
  "property1": [
    { … }
  ],
  "property2": [
    { … }
  ]
}

Get counterparties for an entity

Request

Returns aggregated info about top counterparties by volume (in/out).

Rate Limit: This endpoint has a stricter rate limit of 1 request per second.

Filter parameters:

  • flow: Direction of the transfer. Valid values are "in", "out", or "either".
  • limit: Maximum number of results to return.
  • chains: Comma-separated list of chains (e.g. "ethereum,bsc").
  • tokens: Comma-separated list of token addresses or token IDs. E.g. "ethereum", "usd-coin", or "0x...tokenAddress".
  • timeLast: Time range filter using relative durations (e.g. "24h", "7d", "30d"). Cannot be used with timeGte/timeLte.
  • timeGte/timeLte: Filter from/to a specific timestamp in milliseconds. Cannot be used with 'timeLast' parameter.
  • valueGte/valueLte: Numeric filters on the raw token amount (on-chain units).
  • usdGte/usdLte: Numeric filters on the historical USD value.
Security
ApiKeyAuth
Path
entitystringrequired

The entity ID to get counterparties for.

Query
flowstring

Transfer direction: "in" for incoming, "out" for outgoing, "either" for both directions.

Enum"in""out""either"
limitinteger

Maximum number of counterparties to return (between 1 and 1000).

Default 100
chainsstring

Comma-separated list of chains. For example: "ethereum,bsc".

tokensstring

Comma-separated list of token addresses or token IDs. E.g. "ethereum", "usd-coin", or "0x...tokenAddress".

timeLaststring

Alternative time range filter using relative durations. Examples: "24h", "7d", "30d". Cannot be used with timeGte/timeLte.

timeGtestring

Time range filter (from) in milliseconds (e.g. 1696630274000). Cannot be used with 'timeLast' parameter.

timeLtestring

Time range filter (to) in milliseconds (e.g. 1696716674000). Cannot be used with 'timeLast' parameter.

valueGtenumber

Minimum raw token value (on-chain units).

valueLtenumber

Maximum raw token value (on-chain units).

usdGtenumber

Minimum historical USD value.

usdLtenumber

Maximum historical USD value.

curl -i -X GET \
  'https://docs.intel.arkm.com/_mock/openapi/counterparties/entity/{entity}?flow=in&limit=100&chains=string&tokens=string&timeLast=string&timeGte=string&timeLte=string&valueGte=0&valueLte=0&usdGte=0&usdLte=0' \
  -H 'API-Key: YOUR_API_KEY_HERE'

Responses

Counterparty data

Bodyapplication/json
property name*Array of objects(Counterparty)additional property
Response
application/json
{
  "property1": [
    { … }
  ],
  "property2": [
    { … }
  ]
}

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