Wallets/history

Recent transactions

$0.01per call after 25 free a day

Lists a wallet's latest transactions, newest first, whether each worked, and a plain error name for failures.

Run to see a wallet's recent activity or get a real transaction ID. Never make one up.

Keeps the model from guessing. Gives real transaction IDs. Models can make up realistic-looking fake ones, and every lookup after that fails.

Call it

Transport	How
HTTP	`POST /api/tools/history` with a JSON body of the inputs below.
MCP	`tools/call` with name `history` on `/mcp`.

Name	What it's looking for	Where to get it
`wallet` string (base58 address), required	The wallet to read the transactions of.	The user's address (from their wallet app) or your agent's public key. Not a .sol name or ticker.
`how_many` integer 1-50, optional	How many transactions to return.	Default 10.
`before` string (signature), optional	Start below this transaction, to page further back.	next_before from the previous answer.
`network` "mainnet-beta" \| "devnet", optional	Default "mainnet-beta" (real money).	"devnet" only for test wallets.

Every field the tool returns, what it is, and exactly how it's worked out.

Field	What it is	How it's worked out
`wallet` string	The wallet that was read.	Your input, cleaned up.
`count` number	How many transactions came back.	Length of the list.
`failed_count` number	How many of them failed (failed transactions still pay fees).	Entries with an error.
`transactions[].tx_id` string	The transaction's ID. Pass it to explain_tx.	getSignaturesForAddress.
`transactions[].time` string \| null	When it happened (UTC).	Block time in ISO 8601. null if the node doesn't know.
`transactions[].slot` number	The slot it landed in.	getSignaturesForAddress.
`transactions[].result` "success" \| "failed"	Whether it worked.	failed when the RPC reports an error.
`transactions[].error` string \| null	The failure's short name, e.g. InsufficientFundsForRent.	why_failed run on the raw error. The raw error text when unknown.
`transactions[].memo` string \| null	Memo text attached to the transaction, if any.	getSignaturesForAddress.
`next_before` string \| null	Pass as before to read the next, older page. For amounts and the other side of each transaction, use trace.	The oldest transaction returned; null when there are no more.