> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockdb.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Release Notes

> Changelog of BlockDB product updates, data coverage additions, and API changes.

<Update label="2026-07-19" description="API docs: identifiers, pools filters">
  ## Highlights

  * **Pools** — Documented `token_addresses` filter (AND semantics, max two tokens) on `POST /evm/entities/pools`
  * **Examples & specs** — Normalized `_tracing_id` to 18-byte hex (36 characters); fixed `pool_uid` left-padding, 40-character addresses, and 52-character `contract_id` values in examples
</Update>

<Update label="2026-07-06" description="Lineage API performance improvements">
  ## Highlights

  * Optimized lineage API endpoints for efficiency:
    * `POST /evm/lineage/record`
    * `POST /evm/lineage/parents`
</Update>

<Update label="2026-06-10" description="Data freshness documentation updates">
  ## Highlights

  * Updated data freshness documentation: modified chain buffer table headers and values for clarity
  * Removed outdated backfill & replay behavior section
</Update>

<Update label="2026-06-05" description="Build with AI, Free Research Datasets, navbar and banner">
  ## Highlights

  * Added **Build with AI** section with Cursor rule and Claude skill documentation
  * Introduced **Free Research Datasets** page with access details for Ethereum datasets
  * Updated navbar and site banner for the new features
</Update>

<Update label="2026-05-19" description="New EVM API endpoint: Liquidity Distribution, Dense Mode">
  ## Highlights

  * New API endpoints
    * `POST /evm/reserves/liquidity-distribution` for retrieving liquidity distribution
  * Added Dense mode to the following endpoints:
    * `POST /evm/prices/spot/crypto/ohlc`
    * `POST /evm/prices/spot/crypto/vwap`
    * `POST /evm/prices/spot/crypto/vwap-aggregate`
</Update>

<Update label="2026-04-22" description="Docs: API paths, account endpoints, API keys, shared limits">
  ## Highlights

  * **REST path references** — Aligned documentation with current routes (`POST /evm/entities/tokens/erc20`, `POST /evm/raw/blocks-summary`, `POST /evm/reserves`, `POST /evm/prices/spot/crypto/vwap-aggregate`, and related EVM/cross-links)
  * **Account & usage** — Documented `GET /v1/health` (`{ "status": "ok" }`)
  * **Authentication** — Switched public docs to **API keys** replacing OAuth/JWT/Client Credentials guidance
</Update>

<Update label="2026-02-10" description="New EVM Datasets">
  ## Highlights

  * Updated EVM Datasets IDs
  * Updated/Added datasets:
    * `0111` - Internal Transactions (`blockdb_evm.b0111_internal_transactions_v1`)
    * `0201` - ERC-20 Tokens (`blockdb_evm.b0201_erc20_tokens_v1`)
    * `0202` - ERC-721 Tokens (`blockdb_evm.b0202_erc721_tokens_v1`)
    * `0203` - ERC-1155 Tokens (`blockdb_evm.b0203_erc1155_tokens_v1`)
    * `0304` - Token Transfers (`blockdb_evm.b0304_token_transfers_v1`)
  * Updated/Added API endpoints:
    * `POST /evm/raw/internal-transactions` for retrieving internal transactions
    * `POST /evm/entities/tokens/erc20` for retrieving ERC-20 tokens
    * `POST /evm/entities/tokens/erc721` for retrieving ERC-721 tokens
    * `POST /evm/entities/tokens/erc1155` for retrieving ERC-1155 tokens
    * `POST /evm/transfers/token-transfers` for retrieving all token transfers (native, ERC-20, ERC-721, ERC-1155)
</Update>

<Update label="2026-01-17" description="Pricing Plans">
  ## Highlights

  * Added pricing plans page to the documentation
</Update>

<Update label="2026-01-09" description="WebSocket (WSS) Streams">
  ## Highlights

  * Added WebSocket (WSS) streams pages to the documentation (EVM)
</Update>

<Update label="2025-12-29" description="Data Freshness">
  ## Highlights

  * Added data freshness section to the data catalog
  * Updated Digital Exchange enumeration to include new exchanges
  * Updated Pool Types enumeration to include new pool types
</Update>

<Update label="2025-12-27" description="New Datasets: Liquidity Pool Fee Terms, Swap Fees, Yields">
  ## Highlights

  * Added dataset `0212` - Liquidity Pool Fee Terms (`blockdb_evm.b0212_liquidity_pools_fee_terms_v1`)
  * Added dataset `0303` - Liquidity Pool Swap Fees (`blockdb_evm.b0303_liquidity_pools_swap_fees_v1`)
  * Added dataset `0411` - Liquidity Pool Yields (`blockdb_evm.b0411_liquidity_pools_yields_v1`)
  * New API endpoints:
    * `POST /evm/entities/pools/fee-terms` for retrieving liquidity pool fee terms
    * `POST /evm/swaps/fees` for retrieving swap fees
    * `POST /evm/yields` for retrieving yields
  * API Reference reorganized into category-based folders matching navigation structure
  * Data Catalog reorganized into category-based folders matching navigation structure
</Update>

<Update label="2025-12-20" description="New Dataset: Token-to-Token Prices Swap Prints">
  ## Highlights

  * Added dataset `0302` - Token-to-Token Prices Swap Prints (`blockdb_evm.b0302_token_to_token_prices_swap_prints_v1`)
  * New API endpoint: `POST /evm/prices/spot/crypto/prints` for retrieving executed swap prints with realized execution prices
  * Dataset `0501` - Token-to-Token VWAP renamed to `0405` - Token-to-Token VWAP
</Update>

<Update label="2026-01-17" description="API Reference Enhancements">
  ## Highlights

  * Pagination & Limits overview with standardized default/max limits
  * Pricing Suite updates: refreshed crypto overview and added fiat overview
  * Error Codes page rebuilt to reflect current structured error envelopes
  * Pagination controls and JSON syntax clean-up across multiple endpoints
</Update>

<Update label="2025-11-11" description="BlockDB Docs Launch">
  ## Highlights

  * Public launch of BlockDB documentation portal
  * API guides, data catalog (EVM/SVM), delivery methods, and troubleshooting runbooks now available
  * Coverage indexes and error code reference published
</Update>

<Info>
  Looking for system availability history? See <a href="https://status.blockdb.io">Status</a>.
</Info>