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

{
  "meta": {
    "chain_id": 1,
    "base_token_address": "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "quote_token_address": "a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "request_window": {
      "from_block": 18930000,
      "to_block": 18939999,
      "from_timestamp": null,
      "to_timestamp": null
    },
    "filters": {
      "exchange_ids": [
        1,
        2
      ],
      "pool_uids": [
        "88e6a0c2ddd26feeb64f039a2c41296fcb3f5640000000000000000000000000"
      ]
    }
  },
  "data": [
    {
      "pool_uid": "88e6a0c2ddd26feeb64f039a2c41296fcb3f5640000000000000000000000000",
      "exchange_id": 1,
      "type_id": 201,
      "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_in": "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "token_out": "a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "price_vwap": "3024.112233445566778899",
      "total_volume_in": "580.000000000000000000",
      "total_volume_out": "1750000.000000000000000000",
      "trade_count": 142,
      "_tracing_id": "0405000000000000000000000000000000000001",
      "_parent_tracing_ids": null,
      "_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

  • Dataset ID: 0405 - Token-to-Token VWAP
  • Description: Volume-weighted average price (1m..1d) per pool and token pair direction, anchored to first/last on-chain events in the bucket.
  • CSV Sample: Download
  • JSON Sample: Download

​
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_token_address
string
required
ERC-20 contract address for the quote asset (hex string, 20 bytes, no 0x prefix).

​
Range Filters (mutually exclusive)

​
from_block
number
Starting block number (inclusive) for the query. Use with to_block.
​
to_block
number
Ending block number (inclusive) for the query. Use with from_block.
​
from_timestamp
string
Starting timestamp (ISO-8601). If it falls between blocks, the next block after this timestamp is used. Use with to_timestamp.
​
to_timestamp
string
Ending timestamp (ISO-8601). If it falls between blocks, the last block before this timestamp is used. Use with from_timestamp.
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

​
Meta

​
meta
object
Echo of request metadata applied to the response.
​
meta.chain_id
number
EVM chain ID echoed from the request.
​
meta.base_token_address
string
ERC-20 contract address of the base asset, echoed from the request.
​
meta.quote_token_address
string
ERC-20 contract address of the quote asset, echoed from the request.
​
meta.request_window
object
Normalized block/timestamp bounds derived from the request.
​
meta.filters
object
Filter parameters echoed from the request.

​
Data

​
data
object[]
VWAP aggregates matching the request.
​
data.pool_uid
string
BlockDB pool identifier.
​
data.exchange_id
number
Exchange/DEX identifier.
​
data.type_id
number
Pool type identifier.
​
data.first_block_number
number
Block number of the first contributing event in the window.
​
data.first_block_time
string
Block 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
Block number of the last contributing event in the window.
​
data.last_block_time
string
Block 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.
​
data.token_in
string
Input token address (hex, 20 bytes, no 0x prefix).
​
data.token_out
string
Output token address (hex, 20 bytes, no 0x prefix).
​
data.price_vwap
string
Volume-weighted average price for the interval (token_out per 1 token_in, decimals-adjusted). Returned as a string to preserve precision.
​
data.total_volume_in
string
Total traded token_in in the bucket (decimals-adjusted). Returned as a string to preserve precision.
​
data.total_volume_out
string
Total received token_out in the bucket (decimals-adjusted). Returned as a string to preserve precision.
​
data.trade_count
number
Number of swaps contributing to the VWAP.
​
data._tracing_id
string
Tracing identifier for the VWAP row (hex string, no 0x prefix).
​
data._parent_tracing_ids
string[]
Parent lineage references (hex strings). Typically null/omitted unless lineage expansion is enabled for the dataset.
​
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.

​
Usage Notes

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

{
  "meta": {
    "chain_id": 1,
    "base_token_address": "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "quote_token_address": "a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "request_window": {
      "from_block": 18930000,
      "to_block": 18939999,
      "from_timestamp": null,
      "to_timestamp": null
    },
    "filters": {
      "exchange_ids": [
        1,
        2
      ],
      "pool_uids": [
        "88e6a0c2ddd26feeb64f039a2c41296fcb3f5640000000000000000000000000"
      ]
    }
  },
  "data": [
    {
      "pool_uid": "88e6a0c2ddd26feeb64f039a2c41296fcb3f5640000000000000000000000000",
      "exchange_id": 1,
      "type_id": 201,
      "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_in": "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "token_out": "a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "price_vwap": "3024.112233445566778899",
      "total_volume_in": "580.000000000000000000",
      "total_volume_out": "1750000.000000000000000000",
      "trade_count": 142,
      "_tracing_id": "0405000000000000000000000000000000000001",
      "_parent_tracing_ids": null,
      "_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