Skip to main content
GET
/
v2
/
{chain_name}
/
wallets
/
{wallet_address}
/
transfers
Get Wallet Transfers
curl --request GET \
  --url https://api.data.ormilabs.com/v2/{chain_name}/wallets/{wallet_address}/transfers \
  --header 'Authorization: Bearer <token>'
{
  "transfers": [
    {
      "block_number": 22000000,
      "block_timestamp": "2025-05-12T13:00:05Z",
      "from_address": "0x312e67b47a2a29ae200184949093d92369f80b53",
      "log_index": 23,
      "to_address": "0x312e67b47a2a29ae200184949093d92369f80b53",
      "token": {
        "address": "0x312e67b47a2a29ae200184949093d92369f80b53",
        "decimals": 7,
        "name": "Bacacacac",
        "standard": "ERC-20",
        "symbol": "BAC"
      },
      "transaction_hash": "0x2c9759ce3126199512631f50cb01e40717c880cb094a8974f62f100978fe7071",
      "transaction_index": 23,
      "value": 123123.1321321,
      "value_raw": "1231231321321",
      "token_id": "45"
    }
  ],
  "next_cursor": "ICJkYXNkYXMifQ=="
}

Authorizations

​
Authorization
string
header
required

Enter your API key in the format: Bearer <api_key>. Providing an API key may grant higher rate limits or access to additional features. The API will function without an API key for basic access.

Path Parameters

​
wallet_address
string
required

The wallet address.

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

​
chain_name
enum<string>
required

The name or ID of the blockchain.

Available options:
ethereum,
apechain,
arbitrum,
avalanche,
base,
bsc,
polygon
Example:

"ethereum"

Query Parameters

​
token_address
string

Token contract addresses to filter by.

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"

​
token_standard
enum<string>
default:ERC-20

Token standard to filter by.

Available options:
ERC-20,
ERC-721,
ERC-1155,
NATIVE,
ALL
​
window
string

Specifies time or block range for the query. The format can be a relative duration like 30d or 12h. Or interval of time 2025-08-20T00:00:00Z..2025-08-26T12:00:00Z. Or range of blocks 18000000..18000100.

​
sort_by
enum<string>
default:latest

Sort order for results.

Available options:
latest,
earliest
​
limit
integer
default:50

Maximum number of items to return.

Required range: 1 <= x <= 1000
​
cursor
string

Cursor for pagination to retrieve the next set of results.

Response

Successfully retrieved token transfers.

​
transfers
object[]
required
​
next_cursor
string
Example:

"ICJkYXNkYXMifQ=="