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",
  "include_logs": true,
  "include_function_results": true,
  "limit": 256,
  "cursor": null
}'

{
  "chain_id": 1,
  "data": {
    "dataset": "0301_reserves",
    "_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.

​
Artifact Toggles

​
include_logs
boolean
default:"true"
Toggle for returning raw log objects that contributed to the record.
​
include_function_results
boolean
default:"true"
Toggle for returning decoded EVM return data. Disable when only logs are needed to reduce payload size.

​
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

​
chain_id
number
Network that produced the artifacts.

​
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",
  "include_logs": true,
  "include_function_results": true,
  "limit": 256,
  "cursor": null
}'

{
  "chain_id": 1,
  "data": {
    "dataset": "0301_reserves",
    "_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
}