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
    },
    "filters": {
      "path_ids": [],
      "limit": 25,
      "cursor": null
    }
  },
  "data": [
    {
      "chain_id": 1,
      "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_price_usd": "3200.50",
      "profit_in_usd": "160.025",
      "_tracing_id": "0801c0ffee000000000000000000000000000000000000000000000000000001",
      "_parent_tracing_ids": [
        "0701c0ffee000000000000000000000000000000000000000000000000000001"
      ],
      "_created_at": "2025-11-11T12:00:05Z",
      "_updated_at": "2025-11-11T12:00:05Z"
    }
  ],
  "cursor": null,
  "count": 1
}

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

​
Data

​
data
object[]
Opportunity records matching the request.
​
data.chain_id
number
EVM Chain ID for the record.
​
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_price_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.
​
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
    },
    "filters": {
      "path_ids": [],
      "limit": 25,
      "cursor": null
    }
  },
  "data": [
    {
      "chain_id": 1,
      "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_price_usd": "3200.50",
      "profit_in_usd": "160.025",
      "_tracing_id": "0801c0ffee000000000000000000000000000000000000000000000000000001",
      "_parent_tracing_ids": [
        "0701c0ffee000000000000000000000000000000000000000000000000000001"
      ],
      "_created_at": "2025-11-11T12:00:05Z",
      "_updated_at": "2025-11-11T12:00:05Z"
    }
  ],
  "cursor": null,
  "count": 1
}
Last modified on March 21, 2026