# Get USD flow data for an entity

Retrieves historical USD flow snapshots for the specified entity across all supported chains.

Flow data includes:
- Inflow: USD value flowing into the entity per time period
- Outflow: USD value flowing out of the entity per time period
- Cumulative flows: Running totals of inflows and outflows over time

Entity types supported:
- User entities (custom entities created by users)
- Arkham entities (pre-labeled entities in the Arkham database)

Filter parameters:
- entity: The entity ID to get flow data for
- chains: Optional comma-separated list of chains to filter results (e.g. "ethereum,bsc").

Endpoint: GET /flow/entity/{entity}
Version: 1.0.0
Security: ApiKeyAuth

## Path parameters:

  - `entity` (string, required)
    The entity ID to get flow data for. Can be a user entity ID or an Arkham entity identifier.

## Query parameters:

  - `chains` (string)
    Comma-separated list of chains to filter results. For example: "ethereum,bsc,polygon". If not provided, returns data for all supported chains.

## Response 400 fields (application/json):

  - `error` (string)
    Example: "Bad request"

## Response 401 fields (application/json):

  - `error` (string)
    Example: "API key missing or invalid"


## Response 500 fields