Skip to main content
GET
/
portfolio
/
transactions
Get a detailed history of all transactions in your portfolio
curl --request GET \
  --url https://openapiv1.coinstats.app/portfolio/transactions \
  --header 'X-API-KEY: <api-key>'
{
  "data": [
    {
      "transactionType": "Roll In",
      "date": "2025-08-28T08:35:50.384Z",
      "profitLoss": {
        "profit": -0.21637050600000052,
        "profitPercent": -3.5658153241650377,
        "currentValue": 5.851540654
      },
      "fee": {
        "coin": {
          "rank": 2,
          "identifier": "ethereum",
          "symbol": "ETH",
          "name": "Ethereum",
          "icon": "https://static.coinstats.app/coins/1650455629727.png",
          "priceChange24h": -5.74,
          "priceChange1h": 0.1,
          "priceChange7d": 1.12,
          "priceChange1m": 8.42,
          "volume": 61315198931.43572,
          "isFake": false,
          "isFiat": false
        },
        "count": 0.001,
        "totalWorth": 25.5,
        "price": 25500,
        "toAddress": "0x42382d7853beb8d0ec968de4184a6a3c89cf6b5f",
        "fromAddress": "0x8ac77cbf06b44ec918e4ed99698e83a0be222e0e"
      },
      "portfolioInfo": {
        "name": "KuCoin Spot",
        "icon": "https://static.coinstats.app/portfolio_images/kucoin_dark.png"
      },
      "coinData": {
        "identifier": "pepe",
        "count": 596062,
        "symbol": "PEPE",
        "totalWorth": 6.06791116,
        "currentValue": 5.851540654
      },
      "transfers": [
        {
          "transferType": "Received",
          "items": [
            {
              "coin": {
                "rank": 2,
                "identifier": "ethereum",
                "symbol": "ETH",
                "name": "Ethereum",
                "icon": "https://static.coinstats.app/coins/1650455629727.png",
                "priceChange24h": -5.74,
                "priceChange1h": 0.1,
                "priceChange7d": 1.12,
                "priceChange1m": 8.42,
                "volume": 61315198931.43572,
                "isFake": false,
                "isFiat": false
              },
              "count": -0.00000544,
              "toAddress": "0x42382d7853beb8d0ec968de4184a6a3c89cf6b5f",
              "fromAddress": "0x8ac77cbf06b44ec918e4ed99698e83a0be222e0e",
              "totalWorth": 0.0000054389555199999995,
              "price": 0.999808
            }
          ]
        }
      ],
      "note": {
        "name": "KuCoin Spot",
        "icon": "https://static.coinstats.app/portfolio_images/kucoin_dark.png"
      }
    }
  ],
  "meta": {
    "page": 1,
    "limit": 10
  }
}

Documentation Index

Fetch the complete documentation index at: https://coinstats.app/docs/llms.txt

Use this file to discover all available pages before exploring further.

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
This endpoint is only available for users with a Degen plan subscription (when using shareToken).
  • 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
  • currency: Specify the currency for price values
  • page & limit: Control the number of transactions per page
  • from & to: Filter transactions by date range
  • passcode: Passcode for accessing protected portfolio data (can be passed in header or query parameter)

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

Get Share Token

​
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"

​
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