Pool Fee Terms - BlockDB Docs

Overview

Dataset ID: 0212 - Liquidity Pool Fee Terms
Description: Per-pool fee configuration (total fee + split between user/LP, protocol, and extra recipients).
Sample: Hugging Face Sample

Subscription Parameters

chain_id

number

required

Target EVM network. See the Chain enumeration for supported values.

pool_uids

string[]

Filter updates to specific BlockDB pool identifiers.

exchange_ids

number[]

Filter updates by exchange identifiers. See the DigitalExchange enumeration.

Message Fields

pool_uid

string

BlockDB pool identifier.

exchange_id

number

Exchange/DEX identifier.

type_id

number

Pool type identifier.

block_number

number

Block height where the fee-terms record is anchored.

block_time

string

Block time (ISO-8601).

tx_index

number

Transaction index.

log_index

number

Log index.

total_fee

string | null

Total fee fraction (e.g., 0.003 = 0.30%). String to preserve NUMERIC(18,18) precision.

user_fee

string | null

Absolute fee fraction allocated to LPs/users (same units as total_fee).

protocol_fee

string | null

Absolute fee fraction allocated to protocol/treasury (same units as total_fee).

extra_fee

string | null

Absolute fee fraction allocated to extra destinations (same units as total_fee).

_tracing_id

string

Row-level lineage hash for correlation.

_parent_tracing_ids

string[]

Parent lineage ids (hex).

_created_at

string

Record creation time (ISO-8601).

_updated_at

string

Record last update time (ISO-8601).

Subscription Example

# Use wscat to connect and subscribe
wscat -c wss://api.blockdb.io/v1/evm/ \
  -H "Authorization: Bearer $BLOCKDB_API_KEY" \
  -x '{"action": "subscribe", "dataset_id": "0212", "chain_id": 1, "params": {"pool_uids": ["88e6a0c2ddd26feeb64f039a2c41296fcb3f5640000000000000000000000000"]}}'

Response Example

{
  "chain_id": 1,
  "dataset_id": "0212",
  "is_reorg": false,
  "data": {
    "pool_uid": "88e6a0c2ddd26feeb64f039a2c41296fcb3f5640000000000000000000000000",
    "exchange_id": 1,
    "type_id": 201,
    "block_number": 19001234,
    "block_time": "2025-12-20T12:34:56Z",
    "tx_index": 7,
    "log_index": 12,
    "total_fee": "0.003000000000000000",
    "user_fee": "0.003000000000000000",
    "protocol_fee": "0.000000000000000000",
    "extra_fee": "0.000000000000000000",
    "_tracing_id": "0212c0ffee000000000000000000000000000000000000000000000000000001",
    "_parent_tracing_ids": [
      "0103c0ffee000000000000000000000000000000000000000000000000000001"
    ],
    "_created_at": "2025-12-20T12:35:01Z",
    "_updated_at": "2025-12-20T12:35:01Z"
  }
}

Overview

EVM Streams

​Overview

​Subscription Parameters

​Message Fields

​Subscription Example

​Response Example

Overview

Subscription Parameters

Message Fields

Subscription Example

Response Example