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

## Get counterparties for an address

 - [GET /counterparties/address/{address}](https://docs.intel.arkm.com/openapi/counterparties/getaddresscounterparty.md): 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.

## Get counterparties for an entity

 - [GET /counterparties/entity/{entity}](https://docs.intel.arkm.com/openapi/counterparties/getentitycounterparty.md): 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.