Skip to main content
POST
/
v1
/
evm
/
arb
/
paths
curl -X POST "https://api.blockdb.io/v1/evm/arb/paths" \
  -H "Authorization: Bearer $BLOCKDB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "chain_id": 1,
  "from_block": 21000000,
  "to_block": 21001000,
  "limit": 25
}'

{
  "meta": {
    "chain_id": 1,
    "request_window": {
      "from_block": 21000000,
      "to_block": 21001000,
      "from_timestamp": null,
      "to_timestamp": null
    },
    "resolved_window": {
      "from_block": 21000000,
      "to_block": 21001000,
      "from_timestamp": null,
      "to_timestamp": null
    },
    "filters": {
      "path_ids": [],
      "limit": 25,
      "cursor": null
    }
  },
  "data": [
    {
      "path_id": "a1b2c3d4e5f6789012345678901234567890abcd1234567890abcdef12345678",
      "block_number": 21000500,
      "block_time": "2025-11-11T12:00:00Z",
      "tx_index": 3,
      "log_index": 12,
      "pool_uids": [
        "88e6a0c2ddd26feeb64f039a2c41296fcb3f5640000000000000000000000000",
        "11b815acc87f6f89741a636d1ebfcea40876f8f0000000000000000000000000"
      ],
      "token_cycle": [
        "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
      ],
      "_tracing_id": "0801c0ffee000000000000000000000000000000000000000000000000000001",
      "_parent_tracing_ids": [
        "0301c0ffee000000000000000000000000000000000000000000000000000001"
      ],
      "_created_at": "2025-11-11T12:00:05Z",
      "_updated_at": "2025-11-11T12:00:05Z"
    }
  ],
  "cursor": null,
  "page_count": 1
}
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 network. See the Chain enumeration.

​
Range filters (mutually exclusive)

​
from_block
number
Starting block number (inclusive). Use with to_block.
​
to_block
number
Ending block number (inclusive). Use with from_block.
​
from_timestamp
string
Starting timestamp (ISO-8601). Use with to_timestamp.
​
to_timestamp
string
Ending timestamp (ISO-8601). Use with from_timestamp.
Validation rule:
Provide either a block range or a time range or filter by path_ids (direct selectors).
Do not mix block and timestamp ranges in one request. Invalid combinations return HTTP 400.

​
Direct selectors

​
path_ids
string[]
Filter by 32-byte path_id values (hex string, no 0x prefix).

​
Pagination

​
limit
number
default:"250"
Recommended default 250; maximum 1000 to stay under ~10 MB responses.
​
cursor
string
Opaque pagination cursor from 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.request_window
object
Pure echo of the window you sent (from_block/to_block/from_timestamp/to_timestamp); unset bounds are null.
​
meta.resolved_window
object | null
The concrete window the query actually executed against, after resolving the request. For a block range on a time-bucketed endpoint (OHLC/VWAP/VWAP-aggregate/fiat VWAP), from_timestamp/to_timestamp hold the resolved timestamp window (and from_block/to_block echo your request). For a time range on a block-keyed endpoint, from_block/to_block hold the resolved block range (and the timestamps echo your request). null for selector-only requests (no window). No extra database work is done — these are the values the query already computed.
​
meta.resolved_window.from_block
number | null
Resolved/echoed start block of the executed window.
​
meta.resolved_window.to_block
number | null
Resolved/echoed end block of the executed window.
​
meta.resolved_window.from_timestamp
string | null
Resolved/echoed start timestamp (ISO-8601) of the executed window.
​
meta.resolved_window.to_timestamp
string | null
Resolved/echoed end timestamp (ISO-8601) of the executed window.
​
meta.filters
object
Filter parameters echoed from the request (path_ids, pagination, etc.).

​
Data

​
data
object[]
Path definition records matching the request.
​
data.path_id
string
32-byte path identifier (hex, no 0x).
​
data.block_number
number
Block where the path was first observed.
​
data.block_time
string
UTC timestamp of that block.
​
data.tx_index
number
Transaction index within the block.
​
data.log_index
number
Log index within the transaction.
​
data.pool_uids
string[]
Pool UIDs in canonical cycle order (hex, 32-byte each).
​
data.token_cycle
string[]
Token addresses in canonical cycle order (hex, 20-byte each), e.g. (A,B,A) or (A,B,C,A).
​
data._tracing_id
string
Row tracing id (hex, no 0x).
​
data._parent_tracing_ids
string[]
Parent tracing ids.
​
data._created_at
string
Record creation timestamp (ISO-8601).
​
data._updated_at
string
Last update timestamp (ISO-8601).

​
Envelope

​
cursor
string | null
Pagination cursor.
​
page_count
number
Number of rows in data.
curl -X POST "https://api.blockdb.io/v1/evm/arb/paths" \
  -H "Authorization: Bearer $BLOCKDB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "chain_id": 1,
  "from_block": 21000000,
  "to_block": 21001000,
  "limit": 25
}'

{
  "meta": {
    "chain_id": 1,
    "request_window": {
      "from_block": 21000000,
      "to_block": 21001000,
      "from_timestamp": null,
      "to_timestamp": null
    },
    "resolved_window": {
      "from_block": 21000000,
      "to_block": 21001000,
      "from_timestamp": null,
      "to_timestamp": null
    },
    "filters": {
      "path_ids": [],
      "limit": 25,
      "cursor": null
    }
  },
  "data": [
    {
      "path_id": "a1b2c3d4e5f6789012345678901234567890abcd1234567890abcdef12345678",
      "block_number": 21000500,
      "block_time": "2025-11-11T12:00:00Z",
      "tx_index": 3,
      "log_index": 12,
      "pool_uids": [
        "88e6a0c2ddd26feeb64f039a2c41296fcb3f5640000000000000000000000000",
        "11b815acc87f6f89741a636d1ebfcea40876f8f0000000000000000000000000"
      ],
      "token_cycle": [
        "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
      ],
      "_tracing_id": "0801c0ffee000000000000000000000000000000000000000000000000000001",
      "_parent_tracing_ids": [
        "0301c0ffee000000000000000000000000000000000000000000000000000001"
      ],
      "_created_at": "2025-11-11T12:00:05Z",
      "_updated_at": "2025-11-11T12:00:05Z"
    }
  ],
  "cursor": null,
  "page_count": 1
}
Last modified on May 29, 2026