Skip to main content

​
DatasetId Enumeration

Defines the canonical dataset identifiers used across Historic API responses (e.g., the dataset field and lineage payloads). Each identifier maps to a documented REST endpoint or table. The prefix indicates the functional domain:
  • 01xx — base chain primitives (blocks, transactions, logs, traces)
  • 02xx — pool, token, and contract metadata
  • 03xx — liquidity, reserve snapshots, and transfers
  • 04xx — spot price discovery
  • 05xx — advanced price analytics
  • 06xx — TVL and fiat quote conversion
ValueTableDescriptionNotes
0101blockdb_evm.b0101_blocks_v1Canonical block headers and integrity metadata.POST /evm/raw/blocks
——Derived view over blocks.POST /evm/raw/blocks/summary
0102blockdb_evm.b0102_transactions_v1Executed transactions with provenance fields.POST /evm/raw/transactions
0103blockdb_evm.b0103_logs_v1Event logs emitted by smart contracts.POST /evm/raw/logs
0111blockdb_evm.b0111_internal_transactions_v1Internal transactions (call traces).—
0121blockdb_evm.b0121_contracts_v1Deployed smart contract metadata keyed by address.POST /evm/raw/contracts
0122blockdb_evm.b0122_function_results_v1Contract call return values versioned by block.POST /evm/raw/function-results
0201blockdb_evm.b0201_erc20_tokens_v1ERC-20 token metadata snapshots.POST /evm/tokens/erc20
0202blockdb_evm.b0202_erc721_tokens_v1ERC-721 (NFT) collection registry.POST /evm/tokens/erc721
0203blockdb_evm.b0203_erc1155_tokens_v1ERC-1155 Multi Token contract catalog.—
0211blockdb_evm.b0211_liquidity_pools_v1AMM and liquidity pool descriptions.POST /evm/pools
0212blockdb_evm.b0212_liquidity_pools_fee_terms_v1Pool fee configuration (total fee + recipient splits).POST /evm/pools/fee-terms
0301blockdb_evm.b0301_liquidity_pools_reserves_v1Pool reserve balances and liquidity metrics.POST /evm/reserves
0302blockdb_evm.b0302_token_to_token_prices_swap_prints_v1Executed swap prints (realized prices from actual swap events).POST /evm/prices/spot/crypto/prints
0303blockdb_evm.b0303_liquidity_pools_swap_fees_v1Per-swap fee accounting (executed sizes + fee amounts).POST /evm/swaps/fees
0304blockdb_evm.b0304_token_transfers_v1Token transfer events (native, ERC-20, ERC-721, ERC-1155).—
0401blockdb_evm.b0401_token_to_token_prices_l1_v1Orderbook-style depth snapshots for spot pairs.POST /evm/prices/spot/crypto/depth
0402blockdb_evm.b0402_token_to_token_prices_l2_v1Price impact across notional sizes.POST /evm/prices/spot/crypto/impact-grid
0403blockdb_evm.b0403_token_to_token_prices_l3_v1Candlestick aggregates for spot markets.POST /evm/prices/spot/crypto/ohlc
0405blockdb_evm.b0405_token_to_token_vwap_v1Volume-weighted average prices over windows.POST /evm/prices/spot/crypto/vwap
0411blockdb_evm.b0411_liquidity_pools_yields_v1Pool yield/ROI predictions across fixed horizons.POST /evm/yields
0502blockdb_evm.b0502_token_to_token_lwap_v1Liquidity-weighted average prices across depth bands.POST /evm/prices/spot/crypto/lwap
0601blockdb_evm.b0601_liquidity_pools_tvl_usd_v1Pool TVL (Total Value Locked) snapshots in USD.POST /evm/tvl
0602—Volume-weighted average prices over windows (in USD, EUR etc.).POST /evm/prices/spot/fiat/vwap

​
Usage Notes

  • Responses and lineage records that expose a dataset field will use one of the identifiers above (or the full table name, e.g. blockdb_evm.b0201_erc20_tokens_v1).
  • Entries marked with — in the Notes column represent datasets without a dedicated REST endpoint yet or derived views that do not emit a dedicated dataset identifier.
  • New datasets follow the same prefix scheme; clients should tolerate unknown IDs to remain forward compatible.
  • Use this enumeration to drive UI labels and access control lists rather than hardcoding endpoint prefixes.