Skip to main content

Get inbound STX transfers

Retrieves a list of STX transfers with memos to the given principal. This includes regular transfers from a stx-transfer transaction type, and transfers from contract-call transactions a the send-many-memo bulk sending contract.

Path Parameters

principal

string

REQUIRED

Stacks address or a Contract identifier

Query Parameters

limit

integer

number of items to return

offset

integer

number of items to skip

height

number

Filter for transfers only at this given block height

unanchored

boolean

Include transaction data from unanchored (i.e. unconfirmed) microblocks

until_block

string

returned data representing the state up until that point in time, rather than the current block. Note - Use either of the query parameters but not both at a time.

Responses

200

Success

Schema

OPTIONAL

limit

integer

Possible values: value ≤ 30

offset

integer

total

integer

results

object[]

sender

string

Principal that sent this transfer

amount

string

Transfer amount in micro-STX as integer string

memo

string

Hex encoded memo bytes associated with the transfer

block_height

number

Block height at which this transfer occurred

tx_id

string

The transaction ID in which this transfer occurred

transfer_type

string

Possible values: [bulk-send, stx-transfer, stx-transfer-memo]

Indicates if the transfer is from a stx-transfer transaction or a contract-call transaction

tx_index

number

Index of the transaction within a block