Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
115 changes: 115 additions & 0 deletions api-reference/rpc/http/gettransfersbyaddress.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -219,3 +219,118 @@ Mint and burn transfers are one-sided. Mints have `fromUserAccount: null` and ca
<ResponseField name="TokenTransfer.innerInstructionIdx" type="number">
Index within inner instructions. `0` when the transfer is top-level.
</ResponseField>

## Request Parameters

<ParamField body="address" type="string" required>
Base58-encoded owner wallet address to query transfers for. Pass the wallet owner address, not an associated token account (ATA).
</ParamField>

<ParamField body="with" type="string">
Filter by counterparty address. Returns only transfers to or from this address.
</ParamField>

<ParamField body="direction" type="string" default="any">
Filter by transfer direction relative to the queried address.
- `in`
- `out`
- `any`
</ParamField>

<ParamField body="mint" type="string">
Token mint address. Use So11111111111111111111111111111111111111111 for native SOL and So11111111111111111111111111111111111111112 for WSOL.
</ParamField>

<ParamField body="solMode" type="string" default="merged">
SOL/WSOL display mode. merged treats WSOL as native SOL and excludes wrap/unwrap rows so SOL-denominated history is easier to reconcile; separate preserves WSOL as a distinct SPL token mint and includes wrap/unwrap rows.
- `merged`
- `separate`
</ParamField>

<ParamField body="filters" type="object">
Additional filters for amount, block time, and slot.
</ParamField>

<ParamField body="filters.amount" type="object">
Range comparison filter. All fields are optional and can be combined.
</ParamField>

<ParamField body="filters.amount.gt" type="number">
Greater than.
</ParamField>

<ParamField body="filters.amount.gte" type="number">
Greater than or equal.
</ParamField>

<ParamField body="filters.amount.lt" type="number">
Less than.
</ParamField>

<ParamField body="filters.amount.lte" type="number">
Less than or equal.
</ParamField>

<ParamField body="filters.blockTime" type="object">
Range comparison filter. All fields are optional and can be combined.
</ParamField>

<ParamField body="filters.blockTime.gt" type="number">
Greater than.
</ParamField>

<ParamField body="filters.blockTime.gte" type="number">
Greater than or equal.
</ParamField>

<ParamField body="filters.blockTime.lt" type="number">
Less than.
</ParamField>

<ParamField body="filters.blockTime.lte" type="number">
Less than or equal.
</ParamField>

<ParamField body="filters.slot" type="object">
Range comparison filter. All fields are optional and can be combined.
</ParamField>

<ParamField body="filters.slot.gt" type="number">
Greater than.
</ParamField>

<ParamField body="filters.slot.gte" type="number">
Greater than or equal.
</ParamField>

<ParamField body="filters.slot.lt" type="number">
Less than.
</ParamField>

<ParamField body="filters.slot.lte" type="number">
Less than or equal.
</ParamField>

<ParamField body="limit" type="number" default="100">
Maximum number of transfers to return. Range 1 to 100.
</ParamField>

<ParamField body="paginationToken" type="string">
Cursor from the previous response for pagination.
</ParamField>

<ParamField body="example" type="any">

</ParamField>

<ParamField body="commitment" type="string" default="finalized">
Data commitment level.
- `finalized`
- `confirmed`
</ParamField>

<ParamField body="sortOrder" type="string" default="desc">
Result ordering.
- `asc`
- `desc`
</ParamField>
Loading