Base Chain Data API Documentation

POSThttps://www.brainiac.software/api/v1/chain-data/network-info$0.01 USDC

Get network information

Retrieve Base Mainnet chain ID and network information from the public JSON-RPC endpoint.

Body

Send the JSON body shown in the request example.

Request exampleJSON

{}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/chain-data/network-info" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{}
JSON

POSThttps://www.brainiac.software/api/v1/chain-data/block/latest$0.02 USDC

Get latest block

Retrieve the latest block information from Base Mainnet using the public JSON-RPC endpoint.

Body

Send the JSON body shown in the request example.

Request exampleJSON

{}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/chain-data/block/latest" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{}
JSON

POSThttps://www.brainiac.software/api/v1/chain-data/block/get$0.02 USDC

Get block by number or hash

Retrieve a specific block by number or hash from Base Mainnet. Supports optional full transaction details.

Body

Field	Required	Notes
`blockNumber`	No	integer
`blockHash`	No	string
`fullTransactions`	No	boolean; Default: false

Request exampleJSON

{
  "blockNumber": 12345678,
  "fullTransactions": false
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/chain-data/block/get" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "blockNumber": 12345678,
  "fullTransactions": false
}
JSON

POSThttps://www.brainiac.software/api/v1/chain-data/block/transactions$0.03 USDC

Get block transactions

Retrieve all transactions included in a specific block by number or hash from Base Mainnet.

Body

Field	Required	Notes
`blockNumber`	No	integer
`blockHash`	No	string

Request exampleJSON

{
  "blockNumber": 12345678
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/chain-data/block/transactions" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "blockNumber": 12345678
}
JSON

POSThttps://www.brainiac.software/api/v1/chain-data/transaction/receipt$0.02 USDC

Get transaction receipt

Retrieve the receipt and status for a specific transaction on Base Mainnet, including logs and gas used.

Body

Field	Required	Notes
`txHash`	Yes	string

Request exampleJSON

{
  "txHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/chain-data/transaction/receipt" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "txHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
}
JSON

POSThttps://www.brainiac.software/api/v1/chain-data/logs/search$0.05 USDC

Search contract event logs

Search for contract event logs on Base Mainnet with filters for block range, address, and topics. Limited to 1000 results per request.

Body

Field	Required	Notes
`fromBlock`	No	integer
`toBlock`	No	integer
`blockHash`	No	string
`address`	No	—
`topics`	No	array; Default: []; Array
`limit`	No	integer; Default: 1000

Request exampleJSON

{
  "fromBlock": 12340000,
  "toBlock": 12345000,
  "address": "0x1234567890123456789012345678901234567890",
  "topics": [
    [
      "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
    ]
  ],
  "limit": 100
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/chain-data/logs/search" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "fromBlock": 12340000,
  "toBlock": 12345000,
  "address": "0x1234567890123456789012345678901234567890",
  "topics": [
    [
      "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
    ]
  ],
  "limit": 100
}
JSON

POSThttps://www.brainiac.software/api/v1/chain-data/contract/code$0.02 USDC

Get contract bytecode

Retrieve the bytecode of a smart contract on Base Mainnet at a specific address and optional block number.

Body

Field	Required	Notes
`address`	Yes	string
`blockNumber`	No	integer

Request exampleJSON

{
  "address": "0x1234567890123456789012345678901234567890"
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/chain-data/contract/code" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "address": "0x1234567890123456789012345678901234567890"
}
JSON

POSThttps://www.brainiac.software/api/v1/chain-data/contract/read$0.02 USDC

Execute read-only contract call

Execute a read-only call to a smart contract on Base Mainnet using eth_call. Returns the result without submitting a transaction.

Body

Field	Required	Notes
`address`	Yes	string
`data`	Yes	string
`blockNumber`	No	integer

Request exampleJSON

{
  "address": "0x1234567890123456789012345678901234567890",
  "data": "0x12345678"
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/chain-data/contract/read" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "address": "0x1234567890123456789012345678901234567890",
  "data": "0x12345678"
}
JSON

POSThttps://www.brainiac.software/api/v1/chain-data/gas/estimate$0.02 USDC

Estimate gas for transaction

Estimate the gas required for a transaction on Base Mainnet using eth_estimateGas.

Body

Field	Required	Notes
`from`	No	string
`to`	No	string
`value`	No	string
`data`	No	string

Request exampleJSON

{
  "from": "0x1234567890123456789012345678901234567890",
  "to": "0x1234567890123456789012345678901234567890",
  "data": "0x"
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/chain-data/gas/estimate" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "from": "0x1234567890123456789012345678901234567890",
  "to": "0x1234567890123456789012345678901234567890",
  "data": "0x"
}
JSON

POSThttps://www.brainiac.software/api/v1/chain-data/gas/fee-history$0.03 USDC

Get fee history

Retrieve the fee history for Base Mainnet blocks, including base fees and reward percentiles. Supports EIP-1559.

Body

Field	Required	Notes
`blockCount`	No	integer; Default: 100
`newestBlock`	No	integer
`rewardPercentiles`	No	array; Default: [25,50,75]; Array

Request exampleJSON

{
  "blockCount": 100,
  "rewardPercentiles": [
    25,
    50,
    75
  ]
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/chain-data/gas/fee-history" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "blockCount": 100,
  "rewardPercentiles": [
    25,
    50,
    75
  ]
}
JSON

POSThttps://www.brainiac.software/api/v1/chain-data/address/native-balance$0.01 USDC

Get native ETH balance

Retrieve the native ETH balance of a Base Mainnet address from the public JSON-RPC endpoint.

Body

Field	Required	Notes
`address`	Yes	string
`blockNumber`	No	integer

Request exampleJSON

{
  "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/chain-data/address/native-balance" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}
JSON

POSThttps://www.brainiac.software/api/v1/chain-data/token/erc20-balance$0.01 USDC

Get ERC-20 balance

Retrieve the ERC-20 token balance of a wallet for a specified token contract on Base Mainnet using eth_call.

Body

Field	Required	Notes
`walletAddress`	Yes	string
`tokenAddress`	Yes	string
`blockNumber`	No	integer

Request exampleJSON

{
  "walletAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/chain-data/token/erc20-balance" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "walletAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}
JSON

POSThttps://www.brainiac.software/api/v1/chain-data/token/erc20-total-supply$0.01 USDC

Get ERC-20 total supply

Retrieve the total supply of an ERC-20 token on Base Mainnet using eth_call.

Body

Field	Required	Notes
`tokenAddress`	Yes	string
`blockNumber`	No	integer

Request exampleJSON

{
  "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/chain-data/token/erc20-total-supply" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}
JSON

POSThttps://www.brainiac.software/api/v1/chain-data/token/metadata$0.02 USDC

Get token metadata

Retrieve ERC-20 name, symbol, decimals, and total supply for a token on Base Mainnet where supported.

Body

Field	Required	Notes
`tokenAddress`	Yes	string
`blockNumber`	No	integer

Request exampleJSON

{
  "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/chain-data/token/metadata" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}
JSON

POSThttps://www.brainiac.software/api/v1/chain-data/token/erc20-transfers$0.05 USDC

Get ERC-20 transfers

Retrieve ERC-20 Transfer events for a token contract or wallet on Base Mainnet over a bounded block range.

Body

Field	Required	Notes
`tokenAddress`	No	string
`walletAddress`	No	string
`fromBlock`	No	integer
`toBlock`	No	integer
`limit`	No	integer; Default: 1000

Request exampleJSON

{
  "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "fromBlock": 18000000,
  "toBlock": 18001000,
  "limit": 100
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/chain-data/token/erc20-transfers" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "fromBlock": 18000000,
  "toBlock": 18001000,
  "limit": 100
}
JSON

POSThttps://www.brainiac.software/api/v1/chain-data/address/nonce$0.01 USDC

Get address nonce

Retrieve the transaction nonce for a Base Mainnet address from the public JSON-RPC endpoint.

Body

Field	Required	Notes
`address`	Yes	string
`blockNumber`	No	integer

Request exampleJSON

{
  "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}

Response exampleJSON

cURL

curl -i -X POST "https://www.brainiac.software/api/v1/chain-data/address/nonce" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}
JSON