Skip to Content
API ReferenceLogs & Transfers

Logs & Transfers

getLogs

Raw eth_getLogs query. Filter by contract address, event topic, and block range. Returns up to 1000 logs per call, sorted newest first. Use the cursor to paginate backward. EVM only.

curl -X POST https://your-endpoint.simplystaking.xyz/v1 \
  -H "Content-Type: application/json" \
{
  "jsonrpc": "2.0",
  "method": "getLogs",
  "params": {
    "chain": "ethereum",
    "fromBlock": "latest",
    "toBlock": "latest",
    "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "topic0": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
  },
  "id": 1
}
Common topic0
Transfer (0xddf252ad...)Approval (0x8c5be1e5...)Swap (0xd78ad95f...)

Parameters

NameRequiredDescription
chainyesNetwork slug
fromBlocknoStart block number, defaults to latest
e.g. latest
toBlocknoEnd block number or "latest"
e.g. latest
addressnoContract address to filter
e.g. 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
topic0noEvent signature hash
e.g. 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
cursornoPagination cursor (block number from previous response)

Response Fields

FieldType
dataobject
chainstring
countinteger
limitinteger
hasMoreboolean
cursornull
logsobject[]
addressstring
topicsstring[]
datastring
blockNumberinteger
transactionHashstring
logIndexinteger
removedboolean

Supported Networks

EthereumPolygonBNB ChainOptimismBaseAvalancheArbitrumGnosisMoonbeamLineaHyperliquid
Try It
{
  "jsonrpc": "2.0",
  "method": "getLogs",
  "params": {
    "chain": "ethereum",
    "fromBlock": "latest",
    "toBlock": "latest",
    "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "topic0": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
  },
  "id": 1
}

getTransfers

Returns ERC-20 Transfer events where the address is sender or receiver. Defaults to last 10,000 blocks. Returns up to 1000 logs per call, sorted newest first. Use the cursor to paginate backward. Merges and deduplicates sent/received. EVM only.

curl -X POST https://your-endpoint.simplystaking.xyz/v1 \
  -H "Content-Type: application/json" \
{
  "jsonrpc": "2.0",
  "method": "getTransfers",
  "params": {
    "chain": "ethereum",
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "fromBlock": "latest",
    "toBlock": "latest"
  },
  "id": 1
}

Parameters

NameRequiredDescription
chainyesNetwork slug
addressyesWallet address
e.g. 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
fromBlocknoStart block number, defaults to latest - 10000
e.g. latest
toBlocknoEnd block number or "latest"
e.g. latest
cursornoPagination cursor (block number from previous response)

Response Fields

FieldType
dataobject
chainstring
addressstring
countinteger
limitinteger
hasMoreboolean
cursornull
transfersarray

Supported Networks

EthereumPolygonBNB ChainOptimismBaseAvalancheArbitrumGnosisMoonbeamLineaHyperliquid
Try It
{
  "jsonrpc": "2.0",
  "method": "getTransfers",
  "params": {
    "chain": "ethereum",
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "fromBlock": "latest",
    "toBlock": "latest"
  },
  "id": 1
}