Skip to main content
GET
cURL
4 credits per request

  • Complete list of buy/sell operations
  • Transaction dates and amounts
  • Price information at time of transaction
  • Supports pagination for viewing large transaction sets
  • currency: Specify the currency for price values
  • shareToken OR portfolioId: Provide one of these to identify the portfolio.
    • shareToken: Get this from your CoinStats portfolio page by clicking “Share”
    • portfolioId: Use a portfolio connected via POST /portfolio/wallet or POST /portfolio/exchange
  • If neither is provided, returns transactions from all API-connected portfolios
  • page & limit: Control the number of transactions per page
  • coinId: Filter transactions for a specific coin
  • passcode: Passcode for accessing protected portfolio data (can be passed in header or query parameter)
  • hideUnidentifiedCoins: Set to true to hide transactions of unidentified coins. Defaults to false.

Authorizations

X-API-KEY
string
header
required

API key required to access the endpoints. Generate one from your dashboard at https://openapi.coinstats.app and pass it in the X-API-KEY request header. Never expose your key in client-side code.

Headers

sharetoken
string
passcode
string

Passcode for accessing protected portfolio data

Example:

"123456"

Query Parameters

page
number

Page number to retrieve (1-based indexing)

Example:

1

limit
number

Number of items to return per page

Example:

20

currency
string
required

The fiat currency to return values in

Example:

"USD"

coinId
string

Coin ID to filter transactions for a specific coin

Example:

"bitcoin"

hideUnidentifiedCoins
boolean
default:false

When true, hides transactions of unidentified coins. Accepted values: true, false, 1, 0. Defaults to false.

Example:

true

portfolioId
string

Portfolio ID for accessing a specific API-connected portfolio. Required if shareToken is not provided.

Example:

"abc123def456"

Response

Transactions

data
object[]
required

Array of transaction items

meta
object
required

Pagination metadata