# 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.

## Get intelligence about an address

 - [GET /intelligence/address/{address}](https://docs.intel.arkm.com/openapi/intelligence/getaddressintelligence.md): Returns intelligence data for the specified address.

## Get all intelligence about an address across chains

 - [GET /intelligence/address/{address}/all](https://docs.intel.arkm.com/openapi/intelligence/getalladdressintelligence.md): Returns multi-chain intelligence for the provided address.

## Get intelligence about an address on all chains with additional address information

 - [GET /intelligence/address_enriched/{address}/all](https://docs.intel.arkm.com/openapi/intelligence/getalladdressintelligencewithextraenrichment.md): Similar to /intelligence/address_enriched/{address}, but aggregates data across every supported chain. By default, includes tags, entity predictions, and cluster IDs. Use query parameters to exclude specific enrichments.

## Get intelligence about an address with additional address information

 - [GET /intelligence/address_enriched/{address}](https://docs.intel.arkm.com/openapi/intelligence/getaddressintelligencewithextraenrichment.md): Similar to /intelligence/address/{address}, but includes additional address information (tags, cluster IDs, entity predictions). By default, includes tags, entity predictions, and cluster IDs. Use query parameters to exclude specific enrichments.

## Get intelligence about an entity

 - [GET /intelligence/entity/{entity}](https://docs.intel.arkm.com/openapi/intelligence/getentityintelligence.md): Returns top-level entity information, including associated tags.

## Get entity summary statistics

 - [GET /intelligence/entity/{entity}/summary](https://docs.intel.arkm.com/openapi/intelligence/getentityintelligencesummary.md): Returns precomputed or calculated summary statistics for the specified entity, including:
- Total number of unique addresses (deduplicated across chains)
- Total balance in USD across all chains
- Total transfer volume in USD
- First and last transfer timestamps

Supports both Arkham entities and user entities:
- For Arkham entities (e.g., "binance"): Returns precomputed data when available, falls back to calculation
- For user entities: Always calculates on the fly
- Includes user-added addresses for Arkham entities when authenticated

Shareable user entities: If a user entity is marked as shareable, any authenticated or unauthenticated user can access the summary.

## Get predictions for an entity

 - [GET /intelligence/entity_predictions/{entity}](https://docs.intel.arkm.com/openapi/intelligence/getentitypredictions.md): Returns predicted addresses for the specified entity. These predictions are generated using machine learning algorithms to identify addresses that may belong to the entity based on transaction patterns and other blockchain data. Returns up to 1000 predictions per entity, sorted by USD balance.

## Get intelligence about a contract

 - [GET /intelligence/contract/{chain}/{address}](https://docs.intel.arkm.com/openapi/intelligence/getcontractintelligence.md): Returns contract metadata for the specified chain & address.

## Get intelligence on a token by CoinGecko pricing ID

 - [GET /intelligence/token/{id}](https://docs.intel.arkm.com/openapi/intelligence/gettokenintelligence.md): Retrieve basic token info using the CoinGecko pricing ID.

## Get intelligence on a token by chain/address

 - [GET /intelligence/token/{chain}/{address}](https://docs.intel.arkm.com/openapi/intelligence/gettokenintelligencebychainandaddress.md): Retrieve basic token info using chain + contract address.

## Get tag parameters

 - [GET /tag/{id}/params](https://docs.intel.arkm.com/openapi/intelligence/gettagparams.md): Returns a list of all unique tag parameter combinations for the specified tag.

Pagination parameters:
- limit: Number of items to return per page (1-1000, default 100)
- offset: Number of items to skip from the beginning (default 0)

## Get tag summary statistics

 - [GET /tag/{id}/summary](https://docs.intel.arkm.com/openapi/intelligence/gettagsummary.md): Returns precomputed summary statistics for the specified tag, including total counts of addresses, entities, and unique tag parameters.