Skip to main content

Overview

Enumerations provide canonical reference data used across BlockDB API requests and responses. These identifiers ensure consistent data classification and enable filtering across datasets. All enumeration values are stable and versioned independently from dataset schemas.

Enumeration Reference

Parameter Conventions

  • Enumeration values are case-sensitive and must match exactly as documented
  • Use numeric IDs for chain, exchange, pool type, and transfer type enumerations
  • Use string codes for asset class, fiat currency, and market kind
  • All enumeration values are immutable within a major version

Usage Guidance

  • Cache enumerations client-side โ€” values change infrequently and can be cached for extended periods
  • Validate before requests โ€” check that enumeration values exist before constructing API requests to avoid 400 Bad Request errors
  • Reference in filters โ€” use enumeration IDs in request body filters (e.g., exchange_ids, pool_type_ids) rather than hardcoding values
  • Monitor updates โ€” subscribe to Release Notes for new enumeration values or deprecations

See Also

Last modified on March 31, 2026