Skip to main content
POST
https://api.blockdb.io
/
v1
/
evm
/
lineage
/
genesis
curl -X POST "https://api.blockdb.io/v1/evm/lineage/genesis" \
  -H "Authorization: Bearer $BLOCKDB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "chain_id": 1,
  "tracing_id": "0301000000000000000000000000000000000001",
  "limit": 256,
  "cursor": null
}'

{
  "meta": {
    "chain_id": 1,
    "tracing_id": "0301000000000000000000000000000000000001"
  },
  "data": {
    "dataset": "blockdb_evm.b0301_liquidity_pools_reserves_v1",
    "_tracing_id": "0301000000000000000000000000000000000001",
    "genesis": {
      "logs": [
        {
          "block_number": 18934560,
          "tx_hash": "abcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcd",
          "tx_index": 12,
          "log_index": 0,
          "contract_address": "0000000000000000000000000000000000000000",
          "topics": [
            "ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
          ],
          "data": "00",
          "block_time": "2024-04-01T12:34:56Z"
        }
      ],
      "function_results": [
        {
          "contract": "1234567890abcdef1234567890abcdef12345678",
          "selector": "0902f1ac",
          "decoded_name": "getReserves",
          "output": "0a",
          "decoded_output": {
            "reserve0": "1000000000000000000",
            "reserve1": "2000000000000000000",
            "block_timestamp_last": 1680359696
          }
        }
      ]
    }
  },
  "cursor": null,
  "count": 3
}

​
Description

Returns the raw genesis artifacts—logs and decoded function results—that ultimately created the target record. Use this endpoint when you need to audit the EVM inputs that seeded a derived dataset entry (e.g., reserves pulling from swap logs).

​
Parameters

​
chain_id
number
required
Target EVM network.
​
tracing_id
string
required
Anchor record whose genesis artifacts you want to inspect (hex string, no 0x prefix). _tracing_id remains supported for legacy clients.

​
Pagination Controls

​
cursor
string
Opaque pagination cursor returned from a previous /genesis request.
​
limit
number
Maximum artifacts returned per page. Tighten the limit to keep responses responsive on dense event bursts.

​
Response Fields

​
Meta

​
meta
object
Echo of request metadata applied to the response.
​
meta.chain_id
number
EVM chain ID echoed from the request (network that produced the artifacts).
​
meta.tracing_id
string
Tracing identifier for the record whose artifacts are returned.

​
Data

​
data
object
Envelope describing the artifacts retrieved for the requested record.
​
data.dataset
string
Dataset that ultimately materialized the record (e.g., 0301_reserves).
​
_tracing_id
string
Lineage identifier for the record whose artifacts are returned.
​
genesis
object
Container for the requested artifact types.

​
Envelope Fields

​
cursor
string | null
Pagination cursor for fetching the next batch of artifacts.
​
count
number
Total number of artifacts returned in this response (logs + function results).

​
Next Steps

curl -X POST "https://api.blockdb.io/v1/evm/lineage/genesis" \
  -H "Authorization: Bearer $BLOCKDB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "chain_id": 1,
  "tracing_id": "0301000000000000000000000000000000000001",
  "limit": 256,
  "cursor": null
}'

{
  "meta": {
    "chain_id": 1,
    "tracing_id": "0301000000000000000000000000000000000001"
  },
  "data": {
    "dataset": "blockdb_evm.b0301_liquidity_pools_reserves_v1",
    "_tracing_id": "0301000000000000000000000000000000000001",
    "genesis": {
      "logs": [
        {
          "block_number": 18934560,
          "tx_hash": "abcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcd",
          "tx_index": 12,
          "log_index": 0,
          "contract_address": "0000000000000000000000000000000000000000",
          "topics": [
            "ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
          ],
          "data": "00",
          "block_time": "2024-04-01T12:34:56Z"
        }
      ],
      "function_results": [
        {
          "contract": "1234567890abcdef1234567890abcdef12345678",
          "selector": "0902f1ac",
          "decoded_name": "getReserves",
          "output": "0a",
          "decoded_output": {
            "reserve0": "1000000000000000000",
            "reserve1": "2000000000000000000",
            "block_timestamp_last": 1680359696
          }
        }
      ]
    }
  },
  "cursor": null,
  "count": 3
}