Tokens & Liquidity Overview

Overview

The Tokens & Liquidity suite provides access to token registries and automated market maker (AMM) pool metadata. These endpoints deliver standardized identifiers and classification data that enable consistent cross-dataset joins and filtering. All records include lineage fields linking back to on-chain creation events.

Endpoint Matrix

Endpoint	Summary	Dataset ID	Typical Latency
`POST /evm/entities/tokens/erc20`	ERC-20 token registry	`0201`	< 200 ms
`POST /evm/entities/tokens/erc721`	ERC-721 collection registry	`0202`	< 200 ms
`POST /evm/entities/tokens/erc1155`	ERC-1155 contract registry	`0203`	< 200 ms
`POST /evm/entities/pools`	AMM pool registry	`0211`	< 200 ms
`POST /evm/entities/pools/fee-terms`	Pool fee configuration over time	`0212`	< 200 ms

Parameter Conventions

string

ERC-20 contract address filter (hex string, 20 bytes, no 0x prefix).

string

BlockDB pool identifier for direct pool lookups.

string[]

Pool contract addresses for AMM pools.

number

Starting block number (inclusive) for creation-time filtering.

number

Ending block number (inclusive) for creation-time filtering.

string

Starting timestamp (ISO-8601). If it falls between blocks, the next block after this timestamp is used.

string

Ending timestamp (ISO-8601). If it falls between blocks, the last block before this timestamp is used.

number

required

Chain identifier for the target EVM network. See Chain enumeration for supported values.

number[]

Pool type filters. Use Pool Type enumeration values.

Usage Guidance

Start with pools — Use /evm/entities/pools to discover available liquidity before querying reserves
Join with reserves — Link pool metadata to reserve snapshots via pool_uid for complete liquidity analysis
Use token addresses — the ERC-20 endpoint accepts contract addresses for direct lookups
Filter by creation time — Use block/time ranges to find newly created tokens or pools
Cache token metadata — Token names, symbols, and decimals are immutable; cache aggressively

Common Patterns

Find all ERC-20 tokens created in a time range:

{
  "chain_id": 1,
  "from_timestamp": "2025-01-01T00:00:00Z",
  "to_timestamp": "2025-01-31T23:59:59Z"
}

Lookup specific pool:

{
  "chain_id": 1,
  "contract_address": "88e6a0c2ddd26feeb64f039a2c41296fcb3f5640"
}

Find pools by token pair (AND — both tokens required):

{
  "chain_id": 1,
  "token_addresses": [
    "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
  ]
}

Find all pools listing a single token (exit liquidity):

{
  "chain_id": 1,
  "token_addresses": [
    "a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
  ]
}

Filter pools by type:

{
  "chain_id": 1,
  "pool_type_ids": [
    201,
    301,
    302,
    303,
    304
  ],
  "from_block": 18000000
}

Dataset Relationships

Tokens → Pools: Join ERC-20 tokens to pools via token addresses in pool metadata
Pools → Reserves: Link pool metadata to reserve snapshots using pool_uid
Pools → Fee Terms: Join pool metadata to fee terms using pool_uid for pool economics
Tokens → Prices: Use token addresses in pricing endpoints to get market data

Overview

SDKs

Account & Usage

EVM Endpoints

Enumerations

Tokens & Liquidity Overview

Overview

Endpoint Matrix

Parameter Conventions

Usage Guidance

Common Patterns

Dataset Relationships

See Also

​Overview

​Endpoint Matrix

​Parameter Conventions

​Usage Guidance

​Common Patterns

​Dataset Relationships

​See Also

Overview

Endpoint Matrix

Parameter Conventions

Usage Guidance

Common Patterns

Dataset Relationships

See Also