Read an account's token transfers

Returns the incoming and outgoing token transfers for any account address, newest first, deduped, capped at 50. Transfers carry Monvera’s catalog symbols (USDG, AAPL, NVDA) when the token is known. Direction is relative to the queried account: "out" means it sent, "in" means it received.

GET /api/transactions · public, no token required. Base URL, rate limits, and error shapes: conventions.

Parameters

Name	Type	Required	Description
address	address	yes	The account whose transfers to read. Missing or invalid returns 400.

Returns

Field	Type	Description
transactions	array	Transfers, newest first, up to 50.
transactions[].hash	bytes32	Transaction hash.
transactions[].direction	string	"in" or "out", relative to the queried account.
transactions[].symbol	string	Catalog symbol when known, else the on-chain symbol.
transactions[].amount	number	Human amount moved.
transactions[].counterparty	string	Recipient if out, sender if in.
transactions[].tokenAddress	string	Token contract address.
transactions[].blockNumber	number	Block the transfer landed in.
transactions[].timestamp	number | undefined	Unix seconds, when resolvable.
source	string	"alchemy" or "blockscout".

Example

curl "https://monvera.best/api/transactions?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

{
  "transactions": [
    {
      "hash": "0x5a1b2c3d4e5f60718293a4b5c6d7e8f90112233445566778899aabbccddeeff0",
      "direction": "in",
      "symbol": "AAPL",
      "amount": 0.54,
      "counterparty": "0x7ff1a5ee19330c165146488a7ad8af6cb41da1df",
      "tokenAddress": "0xaf3d76f1834a1d425780943c99ea8a608f8a93f9",
      "blockNumber": 2431902,
      "timestamp": 1751985127
    }
  ],
  "source": "blockscout"
}

Errors

Status	Body	When
400	{"error":"A valid wallet address is required."}	address missing or not a valid address.

Notes

source names which indexer served the response: Alchemy when ALCHEMY_API_KEY is configured, otherwise the keyless Blockscout fallback. Both read the same on-chain transfers. An account with no transfers — or an upstream that returns nothing — yields an empty transactions array with source still set.