Skip to main content

​
Description

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

EndpointSummaryDataset IDTypical Latency
POST /evm/tokens/erc20ERC-20 token registry with metadata and compliance fields0201< 200 ms
POST /evm/poolsAMM pool registry with type classifications and fee tiers0203< 200 ms
POST /evm/pools/fee-termsPool fee configuration (total fee + split across recipients)0204< 200 ms

​
Parameter Conventions

​
address
string
ERC-20 contract address filter (hex string, 20 bytes, no 0x prefix).
​
pool_uid
string
BlockDB pool identifier for direct pool lookups.
​
pool_addresses
string[]
Pool contract addresses for AMM pools.
​
from_block
number
Starting block number (inclusive) for creation-time filtering.
​
to_block
number
Ending block number (inclusive) for creation-time filtering.
​
from_timestamp
string
Starting timestamp (ISO-8601). If it falls between blocks, the next block after this timestamp is used.
​
to_timestamp
string
Ending timestamp (ISO-8601). If it falls between blocks, the last block before this timestamp is used.
​
chain_id
number
required
Chain identifier for the target EVM network. See Chain enumeration for supported values.
​
pool_type_ids
number[]
Pool type filters. Use Pool Type enumeration values.

​
Usage Guidance

  • Start with pools — Use /evm/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,
  "pool_addresses": [
    "88e6a0c2ddd26feeb64f039a2c41296fcb3f564"
  ]
}
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

​
See Also