GET
/
portfolio
/
transactions
cURL
curl --request GET \
  --url https://openapiv1.coinstats.app/portfolio/transactions \
  --header 'X-API-KEY: <api-key>'
{
  "data": [
    {
      "transactionType": "<string>",
      "date": "<string>",
      "coinData": {
        "identifier": "<string>",
        "count": 123,
        "symbol": "<string>",
        "totalWorth": 123,
        "currentValue": 123
      },
      "profitLoss": {
        "profit": 123,
        "profitPercent": 123,
        "currentValue": 123
      },
      "fee": {
        "coin": {
          "rank": 123,
          "identifier": "<string>",
          "symbol": "<string>",
          "name": "<string>",
          "icon": "<string>",
          "isFake": true,
          "isFiat": true,
          "priceChange24h": 123,
          "priceChange1h": 123,
          "priceChange7d": 123,
          "volume": 123
        },
        "count": 123,
        "toAddress": "<string>",
        "fromAddress": "<string>",
        "totalWorth": 123,
        "price": 123
      },
      "transfers": [
        {
          "transferType": "<string>",
          "items": [
            {
              "coin": {
                "rank": 123,
                "identifier": "<string>",
                "symbol": "<string>",
                "name": "<string>",
                "icon": "<string>",
                "isFake": true,
                "isFiat": true,
                "priceChange24h": 123,
                "priceChange1h": 123,
                "priceChange7d": 123,
                "volume": 123
              },
              "count": 123,
              "toAddress": "<string>",
              "fromAddress": "<string>",
              "totalWorth": 123,
              "price": 123
            }
          ]
        }
      ],
      "portfolioInfo": {
        "name": "<string>",
        "icon": "<string>"
      }
    }
  ],
  "meta": {
    "page": 123,
    "limit": 123
  }
}
4 credits per request
Get a detailed history of all transactions in your portfolio:
  • Complete list of buy/sell operations
  • Transaction dates and amounts
  • Price information at time of transaction
  • Supports pagination for viewing large transaction sets
Required:
  • shareToken: Get this from your CoinStats portfolio page by clicking “Share” and copying the token from the share URL
Optional:
  • skip & limit: Control the number of transactions per page
  • currency: Specify the currency for price values
  • from & to: Filter transactions by date range
  • passcode: Optional passcode for accessing protected portfolio data
Note: This endpoint is only available for users with a Degen plan subscription.

Authorizations

​
X-API-KEY
string
header
required

API key needed to access the endpoints. Example: 'demo-api-key'

Query Parameters

​
page
number
Example:

1

​
limit
number
Example:

20

​
currency
string
required
​
coinId
string
​
shareToken
string
required

<b>To access your Share Token</b> Visit <a target='_blank' href='https://coinstats.app/portfolio'>CoinStats Portfolio</a> and make sure you are signed in to your account. In the top-right corner of the page, click on the Share button. This will bring up sharing preferences for your portfolio. Generate a Share Link. In the generated URL, the segment following <code>/p/</code> (e.g., <code>XXX</code>) is your share token. Copy only that token (without additional slashes or characters). Use the Token in the API

​
passcode
string

Optional passcode for accessing protected portfolio data

Example:

"123456"

Response

200
application/json

Transactions

The response is of type object.