Skip to main content
POST
/
v1
/
evm
/
prices
/
spot
/
fiat
/
vwap
curl -X POST "https://api.blockdb.io/v1/evm/prices/spot/fiat/vwap" \
  -H "Authorization: Bearer $BLOCKDB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "chain_id": 1,
  "base_token_address": "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  "quote_currency_code": "USD",
  "from_block": 18930000,
  "to_block": 18939999,
  "exchange_ids": [
    1,
    2
  ],
  "pool_uids": [
    "88e6a0c2ddd26feeb64f039a2c41296fcb3f5640000000000000000000000000"
  ],
  "limit": 200,
  "cursor": null
}'

{
  "base_token_address": "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  "quote_currency_code": "USD",
  "meta": {
    "chain_id": 1,
    "request_window": {
      "from_block": 18930000,
      "to_block": 18939999,
      "from_timestamp": null,
      "to_timestamp": null
    },
    "filters": {
      "exchange_ids": [
        1,
        2
      ],
      "pool_uids": [
        "88e6a0c2ddd26feeb64f039a2c41296fcb3f5640000000000000000000000000"
      ]
    }
  },
  "data": [
    {
      "first_block_number": 18930000,
      "first_block_time": "2025-11-11T18:00:11.000Z",
      "first_tx_index": 12,
      "first_log_index": 5,
      "last_block_number": 18939999,
      "last_block_time": "2025-11-11T18:59:48.000Z",
      "last_tx_index": 44,
      "last_log_index": 2,
      "bucket_start": "2025-11-11T18:00:00.000Z",
      "bucket_seconds": 3600,
      "token_address": "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "price_usd": "3024.112233445566778899",
      "total_notional_usd": "1750000.000000000000000000",
      "hops": 2,
      "sources_count": 4,
      "_tracing_id": "0605000000000000000000000000000000000001",
      "_parent_tracing_ids": [
        "0505000000000000000000000000000000000001",
        "0505000000000000000000000000000000000002"
      ],
      "_created_at": "2025-11-11T19:00:05.000Z",
      "_updated_at": "2025-11-11T19:00:05.000Z"
    }
  ],
  "cursor": null,
  "count": 1
}

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.

Not available on the public API yet: This endpoint is scheduled to become available by the end of May 2026. Until then, calls may fail (for example with 404, 403, or 501). For early access or contract timelines, contact support@blockdb.io.

​
Overview

​
Parameters

​
chain_id
number
required
Target EVM chain. See the Chain enumeration for supported values.
​
base_token_address
string
required
ERC-20 contract address for the base asset (hex string, 20 bytes, no 0x prefix).
​
quote_currency_code
string
required
Fiat currency code for the quote leg.

​
Range Filters (mutually exclusive)

​
from_block
number
Starting block number (inclusive) for the query window.
​
to_block
number
Ending block number (inclusive) for the query window.
​
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.
Validation rule:
You must provide either a block range, a time range, or at least one direct selector.
Providing more than one option results in HTTP 400.
Providing none results in HTTP 400.

​
Direct Selectors

​
exchange_ids
number[]
Filter by exchange identifiers. See the DigitalExchange enumeration.
​
pool_uids
string[]
Restrict to specific BlockDB pool identifiers.

​
Pagination Controls

​
limit
number
default:"250"
Recommended default 250; maximum 1000 to stay under ~10 MB responses.
​
cursor
string
Opaque pagination cursor supplied by a previous response.

​
Response Fields

​
base_token_address
string
ERC-20 contract address of the base asset.
​
quote_currency_code
string
Fiat currency code for the quote leg.

​
Meta

​
meta
object
Echo of request metadata applied to the response.
​
meta.chain_id
number
EVM chain ID echoed from the request.
​
meta.request_window
object
Block/timestamp bounds derived from the request.
​
meta.filters
object
Filters applied to the query (exchange IDs, pool UIDs).

​
Data

​
data
object[]
Fiat VWAP rows matching the request.
​
data.first_block_number
number
On-chain lineage anchor: block of the first contributing event in the bucket window.
​
data.first_block_time
string
Time of the first contributing event (ISO-8601).
​
data.first_tx_index
number
Transaction index of the first contributing event.
​
data.first_log_index
number
Log index of the first contributing event.
​
data.last_block_number
number
On-chain lineage anchor: block of the last contributing event in the bucket window.
​
data.last_block_time
string
Time of the last contributing event (ISO-8601).
​
data.last_tx_index
number
Transaction index of the last contributing event.
​
data.last_log_index
number
Log index of the last contributing event.
​
data.bucket_start
string
Inclusive UTC start of the VWAP bucket (ISO-8601).
​
data.bucket_seconds
number
Bucket width in seconds; one of 60, 300, 900, 1800, 3600, 14400, 86400.
​
data.token_address
string
ERC-20 token address (hex, 20 bytes, no 0x prefix).
​
data.price_usd
string
VWAP in USD for the bucket. Returned as a string to preserve precision.
​
data.total_notional_usd
string
Notional USD volume used in the VWAP weighting. Returned as a string to preserve precision.
​
data.hops
number
Minimum hop count from the stablecoin anchor along b0505 edges.
​
data.sources_count
number
Number of cross-pool pair edges (b0505 rows) used in the hop chain.
​
data._tracing_id
string
BlockDB tracing ID for the row (hex string, no 0x prefix); unique per row.
​
data._parent_tracing_ids
string[]
Tracing IDs of contributing b0505 VWAP lineage (each hex string without 0x).
​
data._created_at
string
Record creation timestamp (ISO-8601).
​
data._updated_at
string
Record update timestamp (ISO-8601).

​
Envelope Fields

​
cursor
string | null
Pagination cursor.
​
count
number
Number of VWAP entries returned.
curl -X POST "https://api.blockdb.io/v1/evm/prices/spot/fiat/vwap" \
  -H "Authorization: Bearer $BLOCKDB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "chain_id": 1,
  "base_token_address": "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  "quote_currency_code": "USD",
  "from_block": 18930000,
  "to_block": 18939999,
  "exchange_ids": [
    1,
    2
  ],
  "pool_uids": [
    "88e6a0c2ddd26feeb64f039a2c41296fcb3f5640000000000000000000000000"
  ],
  "limit": 200,
  "cursor": null
}'

{
  "base_token_address": "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  "quote_currency_code": "USD",
  "meta": {
    "chain_id": 1,
    "request_window": {
      "from_block": 18930000,
      "to_block": 18939999,
      "from_timestamp": null,
      "to_timestamp": null
    },
    "filters": {
      "exchange_ids": [
        1,
        2
      ],
      "pool_uids": [
        "88e6a0c2ddd26feeb64f039a2c41296fcb3f5640000000000000000000000000"
      ]
    }
  },
  "data": [
    {
      "first_block_number": 18930000,
      "first_block_time": "2025-11-11T18:00:11.000Z",
      "first_tx_index": 12,
      "first_log_index": 5,
      "last_block_number": 18939999,
      "last_block_time": "2025-11-11T18:59:48.000Z",
      "last_tx_index": 44,
      "last_log_index": 2,
      "bucket_start": "2025-11-11T18:00:00.000Z",
      "bucket_seconds": 3600,
      "token_address": "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "price_usd": "3024.112233445566778899",
      "total_notional_usd": "1750000.000000000000000000",
      "hops": 2,
      "sources_count": 4,
      "_tracing_id": "0605000000000000000000000000000000000001",
      "_parent_tracing_ids": [
        "0505000000000000000000000000000000000001",
        "0505000000000000000000000000000000000002"
      ],
      "_created_at": "2025-11-11T19:00:05.000Z",
      "_updated_at": "2025-11-11T19:00:05.000Z"
    }
  ],
  "cursor": null,
  "count": 1
}
Last modified on May 12, 2026