TX History

These endpoints are related to retrieving the parsed, detailed transaction history for a wallet. This API is NOT part of a Portfolio API subscription at this time, and is not related to credit usage.

Purchasing

This API is available for purchase for individual wallets via our website. Calls to this API are permitted to be done directly to the API provided you have purchased a subscription.

This API is also available for a yearly fee or pay-as-you-go for customers of any size. Contact us in our Discord for more information.

This API is NOT part of a Portfolio API subscription at this time, and is not related to credit usage.

Authentication

All requests require proper authentication using the method described in the Authentication section.

General Information

A call to update-cache is always required in order to begin the fetch for a wallet. Status can be retrieved with repeated calls to that endpoint.

get

/v1/transaction-history/update-cache

Authorizations

Query parameters

pubkeystringrequired

The public key of the wallet

maxWaitTimenumberrequired

The 'maxWaitTime' param is the MAX amount of time to wait for an update to be done if it is needed.
I've found that 5000ms is long enough to grab the most recent 50 or so txs. If the cache is up to date, no waiting happens and this immediately returns. If the cache update finishes sooner than the time supplied, this method returns at that time. The time supplied is a MAX.

apiKeystring

The api key of the user

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/transaction-history/update-cache?pubkey=text&maxWaitTime=1' \
  --header 'Authorization: Bearer JWT'

200

200

No body

Get a list of transactions with the applied filters

post

/v1/transaction-history/list

Authorizations

Query parameters

pubkeystringrequired

The public key of the wallet

yearnumberrequired

The year of the transactions

includeMintInfobooleanrequired

apiKeystring

The api key of the user

Body

object

Example: { "filters": { page: 1, itemsPerPage: 10, sortDesc: true, startDate : "2021-01-01T00:00:00.000Z", endDate: "2021-01-01T00:00:00.000Z", platforms: ["Jupiter", "Solana"], tokens: ["SOL", "STEP"], txId: "5CLeZVatZA5czyPeJwACjVcR68sXzEjBSiJAuWXg6M46NFagBYak71JmkUPS1D3uwGyFEHcDytqQtVERgSEQ5fyK" types: ["Stake", "Unstake"] }

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/transaction-history/list?pubkey=text&year=1&includeMintInfo=true' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '"\n      {\n        \"filters\": {\n            page: 1,\n            itemsPerPage: 10,\n            sortDesc: true,\n            startDate : \"2021-01-01T00:00:00.000Z\",\n            endDate: \"2021-01-01T00:00:00.000Z\",\n            platforms: [\"Jupiter\", \"Solana\"],\n            tokens: [\"SOL\", \"STEP\"],\n            txId: \"5CLeZVatZA5czyPeJwACjVcR68sXzEjBSiJAuWXg6M46NFagBYak71JmkUPS1D3uwGyFEHcDytqQtVERgSEQ5fyK\"\n            types: [\"Stake\", \"Unstake\"]\n      }"'

201

201

No body