# Get counterparties for an address

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.

Endpoint: GET /counterparties/address/{address}
Version: 1.0.0
Security: ApiKeyAuth

## Path parameters:

  - `address` (string, required)
    The address to get counterparties for.

## Query parameters:

  - `flow` (string)
    Transfer direction: "in" for incoming, "out" for outgoing, "either" for both directions.
    Enum: "in", "out", "either"

  - `limit` (integer)
    Maximum number of counterparties to return (between 1 and 1000).

  - `chains` (string)
    Comma-separated list of chains. For example: "ethereum,bsc".

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

  - `timeLast` (string)
    Time range filter using relative durations. Examples: "24h", "7d", "30d". Cannot be used with timeGte/timeLte.

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

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

  - `valueGte` (number)
    Minimum raw token value (on-chain units).

  - `valueLte` (number)
    Maximum raw token value (on-chain units).

  - `usdGte` (number)
    Minimum historical USD value.

  - `usdLte` (number)
    Maximum historical USD value.