Docs / API: Wallets

Wallet activity

Returns recent curated-token transfers on one EVM chain, or recent signatures on Solana.

GET/api/v1/wallets/{address}/activity

Property	Value
Authentication	Optional. A key raises your limit.
Rate-limit cost	3 units
Status	Live

#Parameters

Name	In	Type	Required	Description
`address`	path	string	Yes	EVM or Solana address.
`chain`	query	string	No	One of `ethereum`, `base`, `bnb`, `arbitrum`, `optimism`, `polygon`, `solana`. Default is `ethereum` for EVM addresses and `solana` for Solana addresses.

#Request

curl -s "https://farbeamlabs.com/api/v1/wallets/0x28C6c06298d514Db089934071355E5743bf21d60/activity?chain=ethereum"

const res = await fetch("https://farbeamlabs.com/api/v1/wallets/0x28C6c06298d514Db089934071355E5743bf21d60/activity?chain=ethereum");
const { data, meta, error } = await res.json();
if (error) throw new Error(`${error.code}: ${error.message}`);
console.log(data);

import os, requests

res = requests.get(
    "https://farbeamlabs.com/api/v1/wallets/0x28C6c06298d514Db089934071355E5743bf21d60/activity?chain=ethereum",
    timeout=30,
)
body = res.json()
if "error" in body:
    raise RuntimeError(body["error"]["code"])
print(body["data"])

You can send this request now in the API playground.

#Response

This response is real. It was captured from the running API when this page was built. Arrays are cut to two items.

JSON

{
  "data": {
    "chain": "base",
    "address": "0x28C6c06298d514Db089934071355E5743bf21d60",
    "blocks_scanned": 5000,
    "scope": "Transfers of the curated token list only.",
    "from_block": 53511851,
    "to_block": 53516851,
    "items": []
  },
  "meta": {
    "request_id": "req_ebf808eda20a",
    "as_of": "2026-11-04T20:10:51.355Z"
  }
}

#Notes

The scan covers up to the last 5,000 blocks. If the public RPC refuses that range, the service retries with a shorter one. blocks_scanned holds the range that was read.

#Errors

HTTP	Code	Meaning
400	`invalid_address`	The address format does not match the chain.
400	`invalid_chain`	The chain is unknown.
502	`upstream_unavailable`	A public data source did not answer.

All errors share one format. See errors.

PreviousWallet overview NextToken report