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",
      "coinData": {
        "identifier": "pepe",
        "count": 596062,
        "symbol": "PEPE",
        "totalWorth": 6.06791116,
        "currentValue": 5.851540654
      },
      "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",
          "isFake": false,
          "isFiat": false,
          "priceChange24h": -5.74,
          "priceChange1h": 0.1,
          "priceChange7d": 1.12,
          "volume": 61315198931.43572
        },
        "count": 0.001,
        "toAddress": "0x42382d7853beb8d0ec968de4184a6a3c89cf6b5f",
        "fromAddress": "0x8ac77cbf06b44ec918e4ed99698e83a0be222e0e",
        "totalWorth": 25.5,
        "price": 25500
      },
      "transfers": [
        {
          "transferType": "Received",
          "items": [
            {
              "coin": {
                "rank": 2,
                "identifier": "ethereum",
                "symbol": "ETH",
                "name": "Ethereum",
                "icon": "https://static.coinstats.app/coins/1650455629727.png",
                "isFake": false,
                "isFiat": false,
                "priceChange24h": -5.74,
                "priceChange1h": 0.1,
                "priceChange7d": 1.12,
                "volume": 61315198931.43572
              },
              "count": -0.00000544,
              "toAddress": "0x42382d7853beb8d0ec968de4184a6a3c89cf6b5f",
              "fromAddress": "0x8ac77cbf06b44ec918e4ed99698e83a0be222e0e",
              "totalWorth": 0.0000054389555199999995,
              "price": 0.999808
            }
          ]
        }
      ],
      "portfolioInfo": {
        "name": "KuCoin Spot",
        "icon": "https://static.coinstats.app/portfolio_images/kucoin_dark.png"
      }
    }
  ],
  "meta": {
    "page": 1,
    "limit": 10
  }
}
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.
  • shareToken: Get this from your CoinStats portfolio page by clicking “Share” and copying the token from the share URL
  • page & limit: Control the number of transactions per page
  • currency: Specify the currency for price values
  • 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 needed to access the endpoints. Example: 'demo-api-key'

Headers

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"

shareToken
string
required
passcode
string

Passcode for accessing protected portfolio data

Example:

"123456"

Response

Transactions

data
object[]
required

Array of transaction items

meta
object
required

Pagination metadata

I