Skip to main content
GET
USDC received

SDK Example

Authorizations

x-api-key
string
header
required

API Key for authentication

Path Parameters

address
string
required

Wallet or account address. SPL transfers are matched by the token accounts this wallet owns.

Query Parameters

limit
integer
default:100

Transfers per page. A page holds whole transactions, so it can hold a few more or fewer. With grouped=true it counts transactions instead, unless dex=include is set and none of type, the address, amount or slot filters, or excludeZero are. At most 100 with minValue or maxValue.

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

pagination.next from the previous page. Keep every other parameter the same between pages. An empty cursor= returns the first page.

sortOrder
enum<string>
default:desc

desc returns newest first, asc oldest first.

Available options:
desc,
asc
start
integer

Block time from, Unix seconds, inclusive. Milliseconds are rejected.

Required range: x >= 0
end
integer

Block time to, Unix seconds, inclusive. Must be at least start.

Required range: x >= 0
startSlot
integer

Slot from, inclusive.

Required range: x >= 0
endSlot
integer

Slot to, inclusive.

Required range: x >= 0
direction
enum<string>
default:all

Transfers received by (in) or sent from (out) the address.

Available options:
all,
in,
out
type
enum<string>

sol for native SOL transfers, spl for SPL and Token-2022 transfers (wrapped SOL included). Both by default.

Available options:
sol,
spl
mint
string

Only transfers of this token. The wrapped SOL mint So11111111111111111111111111111111111111112 returns native SOL and wrapped SOL transfers.

status
enum<string>
default:success

Outcome of the transaction: success (default), failed or any. Each transfer has its own status.

Available options:
success,
failed,
any
dex
enum<string>
default:exclude

exclude (default) leaves out every transfer of a transaction with DEX activity, only returns only those, include returns everything. A transaction has DEX activity when one of its transfers goes to or comes from a pool (an account a DEX or launchpad program owns, or a Raydium or Meteora vault authority): swaps, liquidity adds and removes, and fee or reward claims. A transaction where the address sent one token and received another counts too.

Available options:
exclude,
include,
only
from
string

Up to 5 comma-separated sender addresses (wallet or token account).

to
string

Up to 5 comma-separated receiver addresses (wallet or token account).

counterparty
string

Up to 5 comma-separated addresses on either side (wallet or token account).

excludeFrom
string

Drop transfers from these addresses (up to 5, comma-separated).

excludeTo
string

Drop transfers to these addresses (up to 5, comma-separated).

minAmount
number

Minimum amount in token units (uiAmount), inclusive.

Required range: x >= 0
maxAmount
number

Maximum amount in token units (uiAmount), inclusive.

Required range: x >= 0
minValue
number

Minimum USD value at the time of the transfer, inclusive. Turns on historicPrices, and limit can be at most 100. Each page checks the next limit transfers and returns those that match, so it can hold fewer, or none, while hasMore is true.

Required range: x >= 0
maxValue
number

Maximum USD value at the time of the transfer, inclusive. Turns on historicPrices, and limit can be at most 100.

Required range: x >= 0
historicPrices
boolean
default:false

Add price.usd and value.usd to every transfer: the token's USD price from the last 1-minute candle at or before the transfer, at most an hour old, else null. USDC, USDT and USD1 are priced at 1. Without it, transfers have no price or value.

grouped
boolean
default:false

Also return transactions: the page's transfers grouped by transaction, with totals, dex and swap detection.

excludeZero
boolean
default:false

Drop zero-amount transfers.

Response

Transfers for the address

account
string
required
transfers
object[]
required

Transfers in this page. With grouped=true, every transfer of the returned transactions.

pagination
object
required
grouped
boolean

Present and true when grouped=true

transactions
object[]

grouped=true only

enrichmentStatus
enum<string>

Present when the price lookup ran out of time: prices it did not find are null. Such a page is not cached.

Available options:
partial