# Get swaps

Retrieves a list of swaps (DEX trades) based on various query filters.

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

Filter parameters:
- base: Filter by specific entity or address involved in the swap.
- chains: Specify a comma-separated list of chains (e.g. "ethereum,bsc").
- flow: Direction of the swap relative to base address. Valid values are "in" (receiving token1), "out" (sending token0), or "all".
- from: Filter by sender addresses or entities.
- to: Filter by receiver addresses or entities.
- tokens: Comma-separated list of token addresses or token IDs that appear in either token0 or token1.
- timeLast: Filter swaps from a recent duration (e.g. "24h", "7d").
- timeGte/timeLte: Filter from/to a specific timestamp in milliseconds.
- usdGte/usdLte: Numeric filters on the historical USD value of the swap.
- sortKey: Field by which to sort the results. Options include "time" or "usd".
- sortDir: Sorting direction. Use "asc" for ascending or "desc" for descending.
- limit: Maximum number of results to return (default is 50).
- offset: Pagination offset (default is 0).

Endpoint: GET /swaps
Version: 1.0.0
Security: ApiKeyAuth

## Query parameters:

  - `base` (string)
    Filter by specific entity or address

  - `chains` (string)
    Comma-separated list of chains

  - `flow` (string)
    Swap direction relative to base address
    Enum: "in", "out", "all"

  - `from` (string)
    Filter by sender addresses or entities

  - `to` (string)
    Filter by receiver addresses or entities

  - `tokens` (string)
    Comma-separated list of token addresses or IDs

  - `timeLast` (string)
    Time range filter (e.g. "24h", "7d")

  - `timeGte` (string)
    Start time in milliseconds

  - `timeLte` (string)
    End time in milliseconds

  - `usdGte` (number)
    Minimum historical USD value

  - `usdLte` (number)
    Maximum historical USD value

  - `sortKey` (string)
    Field to sort by
    Enum: "time", "usd"

  - `sortDir` (string)
    Sort direction
    Enum: "asc", "desc"

  - `limit` (integer)
    Maximum number of results

  - `offset` (integer)
    Pagination offset

## Response 200 fields (application/json):

  - `swaps` (array)

  - `swaps.id` (string)
    Example: "0x1aa3b159d3a20326daf41fee27225fd4229d0428179513bbbd2fc1aa469c041b_327"

  - `swaps.chain` (string)
    Enum: "ethereum", "polygon", "bsc", "optimism", "avalanche", "arbitrum_one", "bitcoin", "tron", "base", "flare", "linea", "manta", "blast", "ton", "solana", "mantle", "dogecoin", "sonic"

  - `swaps.blockTimestamp` (string)
    Example: "2021-10-22T17:26:37Z"

  - `swaps.blockNumber` (integer)
    Example: 13468727

  - `swaps.blockHash` (string)
    Example: "0x6aa90482faf144b3f66e4ee569cc64958660ef40cdec239c363d3d4de7c56cc8"

  - `swaps.contractAddress` (object)
    Blockchain address intelligence object

  - `swaps.contractAddress.address` (string)
    The raw address (hex for EVM chains, base58 for Bitcoin, etc.)
    Example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

  - `swaps.contractAddress.depositServiceID` (string,null)

  - `swaps.contractAddress.arkhamEntity` (object,null)

  - `swaps.contractAddress.arkhamEntity.name` (string,null)
    Example: "Vitalik Buterin"

  - `swaps.contractAddress.arkhamEntity.note` (string,null)

  - `swaps.contractAddress.arkhamEntity.type` (string,null)
    Example: "individual"

  - `swaps.contractAddress.arkhamEntity.service` (string,null)

  - `swaps.contractAddress.arkhamEntity.addresses` (string,null)

  - `swaps.contractAddress.arkhamEntity.website` (string,null)

  - `swaps.contractAddress.arkhamEntity.twitter` (string,null)
    Example: "https://twitter.com/VitalikButerin"

  - `swaps.contractAddress.arkhamEntity.crunchbase` (string,null)
    Example: "https://www.crunchbase.com/person/vitalik-buterin"

  - `swaps.contractAddress.arkhamEntity.linkedin` (string,null)
    Example: "https://www.linkedin.com/in/vitalik-buterin-267a7450"

  - `swaps.contractAddress.arkhamLabel` (object,null)

  - `swaps.contractAddress.arkhamLabel.address` (string,null)
    Example: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

  - `swaps.contractAddress.arkhamLabel.chainType` (string)
    Enum: "evm", "bitcoin", "tron", "ton", "solana", "dogecoin"

  - `swaps.contractAddress.isUserAddress` (boolean,null)

  - `swaps.contractAddress.contract` (boolean,null)

  - `swaps.sender` (object)
    Blockchain address intelligence object

  - `swaps.receiver` (object)
    Blockchain address intelligence object

  - `swaps.unitValue0` (number,null)
    Example: 117299080646369.72

  - `swaps.unitValue1` (number,null)
    Example: -145.2145781084285

  - `swaps.historicalUSD` (number,null)
    Example: 2370363.5776504306

  - `swaps.token0` (string,null)
    Example: "0x97b65710D03E12775189F0D113202cc1443b0aa2"

  - `swaps.token0Id` (string,null)
    Example: "weth"

  - `swaps.token0Name` (string,null)
    Example: "ASTROELON"

  - `swaps.token0Symbol` (string,null)
    Example: "ELONONE"

  - `swaps.token0Decimals` (integer,null)
    Example: 9

  - `swaps.token1` (string,null)
    Example: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"

  - `swaps.token1Id` (string,null)
    Example: "weth"

  - `swaps.token1Name` (string,null)
    Example: "Wrapped Ether"

  - `swaps.token1Symbol` (string,null)
    Example: "WETH"

  - `swaps.token1Decimals` (integer,null)
    Example: 18

  - `swaps.valid` (boolean,null)
    Example: true

  - `swaps.contractEntityId` (string,null)
    Example: "uniswap"

  - `count` (integer)
    Example: 10

## Response 400 fields (application/json):

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

## Response 401 fields (application/json):

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