Skip to main content
POST
/
v1
/
evm
/
arb
/
opportunities
curl -X POST "https://api.blockdb.io/v1/evm/arb/opportunities" \
  -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": [
    {
      "block_number": 21000500,
      "block_time": "2025-11-11T12:00:00Z",
      "tx_index": 8,
      "log_index": 4,
      "path_id": "a1b2c3d4e5f6789012345678901234567890abcd1234567890abcdef12345678",
      "is_reversed": false,
      "pool_uids": [
        "88e6a0c2ddd26feeb64f039a2c41296fcb3f5640000000000000000000000000",
        "11b815acc87f6f89741a636d1ebfcea40876f8f0000000000000000000000000"
      ],
      "token_path": [
        "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
      ],
      "amounts": [
        "1000000000000000000",
        "3500000000",
        "1000500000000000000"
      ],
      "profit_in_tokens": "50000000000000000",
      "token_vwap_usd": "3200.50",
      "profit_in_usd": "160.025",
      "_tracing_id": "0901c0ffee000000000000000000000000000000000000000000000000000001",
      "_parent_tracing_ids": [
        "0801c0ffee000000000000000000000000000000000000000000000000000001"
      ],
      "_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.
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).

​
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, pagination, etc.

​
Data

​
data
object[]
Opportunity records matching the request.
​
data.block_number
number
Observation block.
​
data.block_time
string
UTC timestamp of the observation.
​
data.tx_index
number
Transaction index within the block.
​
data.log_index
number
Log index within the transaction.
​
data.path_id
string
32-byte path id (hex, no 0x).
​
data.is_reversed
boolean
true if the path was evaluated in the reversed direction.
​
data.pool_uids
string[]
Pool UIDs in evaluated (directional) order (hex).
​
data.token_path
string[]
Token addresses in evaluated order (hex).
​
data.amounts
string[]
Per-hop amounts as decimal strings, aligned with token_path.
​
data.profit_in_tokens
string
Estimated profit in token_path[0] units.
​
data.token_vwap_usd
string
USD price of token_path[0].
​
data.profit_in_usd
string
Estimated profit in USD.
​
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/opportunities" \
  -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": [
    {
      "block_number": 21000500,
      "block_time": "2025-11-11T12:00:00Z",
      "tx_index": 8,
      "log_index": 4,
      "path_id": "a1b2c3d4e5f6789012345678901234567890abcd1234567890abcdef12345678",
      "is_reversed": false,
      "pool_uids": [
        "88e6a0c2ddd26feeb64f039a2c41296fcb3f5640000000000000000000000000",
        "11b815acc87f6f89741a636d1ebfcea40876f8f0000000000000000000000000"
      ],
      "token_path": [
        "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
      ],
      "amounts": [
        "1000000000000000000",
        "3500000000",
        "1000500000000000000"
      ],
      "profit_in_tokens": "50000000000000000",
      "token_vwap_usd": "3200.50",
      "profit_in_usd": "160.025",
      "_tracing_id": "0901c0ffee000000000000000000000000000000000000000000000000000001",
      "_parent_tracing_ids": [
        "0801c0ffee000000000000000000000000000000000000000000000000000001"
      ],
      "_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