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
    },
    "filters": {
      "path_ids": [],
      "limit": 25,
      "cursor": null
    }
  },
  "data": [
    {
      "chain_id": 1,
      "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": "0702c0ffee000000000000000000000000000000000000000000000000000001",
      "_parent_tracing_ids": [
        "0701c0ffee000000000000000000000000000000000000000000000000000001"
      ]
    }
  ],
  "cursor": null,
  "count": 1
}

​
Overview

  • Dataset ID: 0702 - Arb Path Status
  • Description: Path status events (b0701_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.
  • Sample: Hugging Face Sample

​
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
Normalized block/timestamp bounds derived from the request.
​
meta.filters
object
Echo of path_ids, is_active, pagination, etc.

​
Data

​
data
object[]
Path status events matching the request.
​
data.chain_id
number
EVM Chain ID for the record.
​
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.

​
Envelope

​
cursor
string | null
Pagination cursor.
​
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
    },
    "filters": {
      "path_ids": [],
      "limit": 25,
      "cursor": null
    }
  },
  "data": [
    {
      "chain_id": 1,
      "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": "0702c0ffee000000000000000000000000000000000000000000000000000001",
      "_parent_tracing_ids": [
        "0701c0ffee000000000000000000000000000000000000000000000000000001"
      ]
    }
  ],
  "cursor": null,
  "count": 1
}
Last modified on March 21, 2026