Wallet Transactions Lookup

Get a wallet's recent ETH transfers on Ethereum mainnet: up to 50, with hash, value, counterparty, time and direction.

Pay by wallet (x402) wallet-transactions-lookup

Example

Example answer

{
  "address": "0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe",
  "chain_id": "1",
  "sent_count": 0,
  "transactions": [
    {
      "to": "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
      "from": "0xfb36ee1e268b1b4307c33bc05b210884270db149",
      "hash": "0x48d68cc412bf00b4a37eccd55ac642245f1db423d2557d8b322f2af44d7e4ec6",
      "gas_used": 24259,
      "is_error": false,
      "direction": "received",
      "timestamp": "2026-03-27T20:40:35.000Z",
      "value_eth": 0,
      "block_number": 24751345
    },
    {
      "to": "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
      "from": "0x134c0a639ced2168e3b96ccaaa8a425c462ad171",
      "hash": "0x3cc3dd27c74f5033e2829db9d2401f6fb918941eae9d92d8e84d98cbc935683d",
      "gas_used": 24259,
      "is_error": false,
      "direction": "received",
      "timestamp": "2026-03-27T20:34:35.000Z",
      "value_eth": 0,
      "block_number": 24751315
    },
    {
      "to": "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
      "from": "0x651f3a9a59b69e284f834f4914a6ed206a516371",
      "hash": "0xedc0180c7a4720bcea8c88d998cfe16a54a04f05718163c2687f062db566a689",
      "gas_used": 24320,
      "is_error": false,
      "direction": "received",
      "timestamp": "2026-03-27T20:14:11.000Z",
      "value_eth": 0,
      "block_number": 24751213
    },
    {
      "to": "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
      "from": "0x651f3a9a59b69e284f834f4914a6ed206a516371",
      "hash": "0x664ea2ee718538654e745b687869e46756053779a80c00e1462d88a1223344ad",
      "gas_used": 24636,
      "is_error": false,
      "direction": "received",
      "timestamp": "2026-03-27T20:11:59.000Z",
      "value_eth": 0,
      "block_number": 24751202
    },
    {
      "to": "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
      "from": "0x651f3a9a59b69e284f834f4914a6ed206a516371",
      "hash": "0x23ba0d00f2660004f749cc30c570edde8f346a0b37d3bceb364f3c65a091c3fd",
      "gas_used": 23913,
      "is_error": false,
      "direction": "received",
      "timestamp": "2026-03-27T20:00:23.000Z",
      "value_eth": 0,
      "block_number": 24751144
    }
  ],
  "received_count": 5,
  "total_returned": 5
}

Inputs

Field	Type	Required	What it is
`limit`	number	No	Number of transactions (1-50). Default: 20
`address`	string	Yes	Wallet address (0x...)
`chain_id`	string	No	Chain ID: 1 (Ethereum), 8453 (Base), 42161 (Arbitrum One), 10 (OP Mainnet) or 137 (Polygon PoS). Default: 1

Output fields

How reliably each field appears in a successful answer.

Field	Type	Appears
`note`	string	Always (present in every successful answer)
`address`	string	Usually (present for most inputs)
`chain_id`	string	Always (present in every successful answer)
`sent_count`	number	Usually (present for most inputs)
`transactions`	array	Usually (present for most inputs)
`native_symbol`	string	Always (present in every successful answer)
`received_count`	number	Usually (present for most inputs)
`total_returned`	number	Usually (present for most inputs)

How to call it

The same tool through each route. MCP clients reach it through Strale’s server at https://api.strale.io/mcp; the call below is what the agent sends.

# Needs an API key. max_price_cents caps what this call may cost.
curl -X POST https://api.strale.io/v1/do \
  -H "Authorization: Bearer $STRALE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "capability_slug": "wallet-transactions-lookup",
    "inputs": {},
    "max_price_cents": 2
  }'

{
  "tool": "strale_execute",
  "arguments": {
    "slug": "wallet-transactions-lookup",
    "inputs": {},
    "max_price_cents": 2
  }
}

import { Strale } from "straleio";

const strale = new Strale({ apiKey: process.env.STRALE_API_KEY! });
const result = await strale.do({
  capability_slug: "wallet-transactions-lookup",
  inputs: {},
  max_price_cents: 2,
});

import os
from straleio import Strale, DoRequest

strale = Strale(api_key=os.environ["STRALE_API_KEY"])
result = strale.do(DoRequest(
    capability_slug="wallet-transactions-lookup",
    inputs={},
    max_price_cents=2,
))

# No account. The first request answers 402 with the price in USDC;
# an x402 client pays it from your wallet and repeats the request.
curl -i 'https://api.strale.io/x402/v2/wallet-transactions-lookup?'

Limitations

Output reflects Alchemy's JSON-RPC and transfer index for the requested chain at query time. Dependent on upstream API availability; may degrade if the provider rate-limits or is temporarily unavailable.
Chains covered
Covers Ethereum (1), Base (8453), Arbitrum One (42161), OP Mainnet (10) and Polygon PoS (137) through Alchemy; other `chain_id` values are refused. Values use the chain’s native coin named in `native_symbol`, including POL on Polygon.
No gas or failure status
Transactions come from a transfer index without receipts, so gas_used and is_error are always null, and contract calls that moved none of the chain's native coin are not listed.