Skip to main content
POST
/
v1
/
evm
/
arb
/
path-status
curl -X POST "https://api.blockdb.io/v1/evm/arb/path-status" \
  -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": 21000800,
      "block_time": "2025-11-11T14:00:00Z",
      "tx_index": 5,
      "log_index": 2,
      "is_active": true,
      "trigger_pool_uid": "88e6a0c2ddd26feeb64f039a2c41296fcb3f5640000000000000000000000000",
      "_tracing_id": "0802c0ffee000000000000000000000000000000000000000000000000000001",
      "_parent_tracing_ids": [
        "0801c0ffee000000000000000000000000000000000000000000000000000001"
      ],
      "_created_at": "2025-11-11T14:00:01.000Z",
      "_updated_at": "2025-11-11T14:00:01.000Z"
    }
  ],
  "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

  • Dataset ID: 0802 - Arb Path Status
  • Description: Path status events (b0801_arb_path_status_v1): active/inactive transitions keyed by (path_id, block_number, tx_index, log_index); trigger_pool_uid identifies the pool whose TVL/state change produced the event.
  • CSV Sample: Download
  • JSON Sample: Download

​
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.
Do not mix block and timestamp ranges in one request.

​
Direct selectors

​
path_ids
string[]
Filter by 32-byte path_id values (hex, no 0x prefix). Cross-reference Arbitrage paths for path definitions.
​
is_active
boolean
When set, return only rows where the path became active (true) or inactive (false).

​
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
Echo of path_ids, is_active, pagination, etc.

​
Data

​
data
object[]
Path status events matching the request.
​
data.path_id
string
32-byte path id (hex, no 0x).
​
data.block_number
number
Block of the status event.
​
data.block_time
string
UTC timestamp of the event row.
​
data.tx_index
number
Transaction index within the block.
​
data.log_index
number
Log index within the transaction.
​
data.is_active
boolean
Whether the path is active after this event.
​
data.trigger_pool_uid
string
32-byte pool UID whose state change triggered the status update (hex, no 0x).
​
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
Record 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/path-status" \
  -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": 21000800,
      "block_time": "2025-11-11T14:00:00Z",
      "tx_index": 5,
      "log_index": 2,
      "is_active": true,
      "trigger_pool_uid": "88e6a0c2ddd26feeb64f039a2c41296fcb3f5640000000000000000000000000",
      "_tracing_id": "0802c0ffee000000000000000000000000000000000000000000000000000001",
      "_parent_tracing_ids": [
        "0801c0ffee000000000000000000000000000000000000000000000000000001"
      ],
      "_created_at": "2025-11-11T14:00:01.000Z",
      "_updated_at": "2025-11-11T14:00:01.000Z"
    }
  ],
  "cursor": null,
  "page_count": 1
}
Last modified on May 29, 2026