Skip to main content
POST
Parsed Transaction History
The request body, response schema, and examples on this page are generated from the OpenAPI definition. Each item in data uses the same TransactionResult shape returned by Parse Transactions; this method only wraps results in a page object and adds paginationToken when another page is available.

Notes

  • address is required. To search an address’s history by program instruction or token mint server-side, use Scan Transaction History.
  • Only successful transactions are returned unless you set status to any or failed.
  • If a stored transaction in the page cannot be decoded, the whole request fails with 500 and {"error": "internal server error"} instead of returning an item-level error.

Request Parameters

string
required
Address whose transaction history should be fetched.
number
default:"100"
Number of transactions to return.
string
Return transactions before this signature.
string
Return transactions after this signature.
string
Cursor returned by a previous page. Shape is slot:transactionIndex.
string
default:"desc"
Sort order for returned transactions.
  • asc
  • desc
string
default:"confirmed"
Commitment level used for the history fetch. processed is not supported.
  • confirmed
  • finalized
string
default:"succeeded"
Execution result to include.
  • succeeded
  • failed
  • any
string
default:"none"
Whether to include transactions that reference only a token account owned by address, not address itself. Many incoming token transfers touch only the recipient’s token account. none leaves them out, balanceChanged includes those that change the token account’s balance, and all includes all of them.
  • none
  • balanceChanged
  • all
number
Minimum slot at which the request can be evaluated.
string
default:"none"
Encoding of the original Solana transaction returned as rawTransaction on each successful result, in the getTransaction shape. none returns no raw transaction.
  • none
  • json
  • jsonParsed
  • base64
boolean
deprecated
Deprecated. true is the same as rawTransaction: "json". Setting both includeRawTransaction and rawTransaction returns 400.
object
Slot comparison bounds. Each bound is optional.
number
Match values greater than this value.
number
Match values greater than or equal to this value.
number
Match values less than this value.
number
Match values less than or equal to this value.
object
Block-time comparison bounds in Unix seconds. Each bound is optional.
number
Match values greater than this value.
number
Match values greater than or equal to this value.
number
Match values less than this value.
number
Match values less than or equal to this value.

Authorizations

api-key
string
query
required

Body

application/json

Request body for fetching parsed transaction history for an address.

address
string
required

Address whose transaction history should be fetched.

limit
integer
default:100

Number of transactions to return.

Required range: 1 <= x <= 100
beforeSignature
string

Return transactions before this signature.

afterSignature
string

Return transactions after this signature.

paginationToken
string

Cursor returned by a previous page. Shape is slot:transactionIndex.

sortOrder
enum<string>
default:desc

Sort order for returned transactions.

Available options:
asc,
desc
commitment
enum<string>
default:confirmed

Commitment level used for the history fetch. processed is not supported.

Available options:
confirmed,
finalized
status
enum<string>
default:succeeded

Execution result to include.

Available options:
succeeded,
failed,
any
tokenAccounts
enum<string>
default:none

Whether to include transactions that reference only a token account owned by address, not address itself. Many incoming token transfers touch only the recipient's token account. none leaves them out, balanceChanged includes those that change the token account's balance, and all includes all of them.

Available options:
none,
balanceChanged,
all
minContextSlot
integer

Minimum slot at which the request can be evaluated.

rawTransaction
enum<string>
default:none

Encoding of the original Solana transaction returned as rawTransaction on each successful result, in the getTransaction shape. none returns no raw transaction.

Available options:
none,
json,
jsonParsed,
base64
includeRawTransaction
boolean
deprecated

Deprecated. true is the same as rawTransaction: "json". Setting both includeRawTransaction and rawTransaction returns 400.

slot
object

Slot comparison bounds. Each bound is optional.

time
object

Block-time comparison bounds in Unix seconds. Each bound is optional.

Response

A page of parsed transaction results.

Page of parsed transaction results returned by transaction history.

data
object[]

Parsed transaction results. Each item has the same TransactionResult shape returned by /v1/parsed-events/transactions.

paginationToken
string

Cursor for the next page. Missing when the service reached the end of the available page range.