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,
          "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,
                "volume": 61315198931.43572,
                "isFake": false,
                "isFiat": false
              },
              "count": -0.00000544,
              "toAddress": "0x42382d7853beb8d0ec968de4184a6a3c89cf6b5f",
              "fromAddress": "0x8ac77cbf06b44ec918e4ed99698e83a0be222e0e",
              "totalWorth": 0.0000054389555199999995,
              "price": 0.999808
            }
          ]
        }
      ]
    }
  ],
  "meta": {
    "page": 1,
    "limit": 10
  }
}

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,
          "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,
                "volume": 61315198931.43572,
                "isFake": false,
                "isFiat": false
              },
              "count": -0.00000544,
              "toAddress": "0x42382d7853beb8d0ec968de4184a6a3c89cf6b5f",
              "fromAddress": "0x8ac77cbf06b44ec918e4ed99698e83a0be222e0e",
              "totalWorth": 0.0000054389555199999995,
              "price": 0.999808
            }
          ]
        }
      ]
    }
  ],
  "meta": {
    "page": 1,
    "limit": 10
  }
}

4 credits per request

You will get

Complete list of buy/sell operations
Transaction dates and amounts
Price information at time of transaction
Supports pagination for viewing large transaction sets

Required

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

Optional

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"

Get Share Token

passcode

string

Passcode for accessing protected portfolio data

Example:

"123456"

Response

Transactions

data

object[]

required

Array of transaction items

Show child attributes

data.transactionType

enum<string>

required

Type of transaction performed

Available options:

Sent,

Dust Convert,

Roll In,

Received,

Swap,

Buy,

Sell

Example:

"Roll In"

data.date

string

required

ISO 8601 timestamp of when the transaction occurred

Example:

"2025-08-28T08:35:50.384Z"

data.profitLoss

object

required

Profit and loss information for the transaction

Show child attributes

data.profitLoss.profit

number

required

Profit or loss amount in USD (positive for profit, negative for loss)

Example:

-0.21637050600000052

data.profitLoss.profitPercent

number

required

Profit or loss percentage (positive for profit, negative for loss)

Example:

-3.5658153241650377

data.profitLoss.currentValue

number

required

Current market value of the position in USD

Example:

5.851540654

data.fee

object

required

Transaction fee information

Show child attributes

data.fee.coin

object

required

Information about the coin used for transaction fees

Show child attributes

data.fee.coin.rank

number

required

Market rank of the coin

Example:

2

data.fee.coin.identifier

string

required

Unique identifier for the coin

Example:

"ethereum"

data.fee.coin.symbol

string

required

Trading symbol of the coin

Example:

"ETH"

data.fee.coin.name

string

required

Full name of the coin

Example:

"Ethereum"

data.fee.coin.icon

string

required

URL to the coin icon image

Example:

"https://static.coinstats.app/coins/1650455629727.png"

data.fee.coin.priceChange24h

number

required

Price change percentage in the last 24 hours

Example:

-5.74

data.fee.coin.priceChange1h

number

required

Price change percentage in the last 1 hour

Example:

0.1

data.fee.coin.priceChange7d

number

required

Price change percentage in the last 7 days

Example:

1.12

data.fee.coin.volume

number

required

Trading volume in the last 24 hours (USD)

Example:

61315198931.43572

data.fee.coin.isFake

boolean

Whether the coin is identified as fake

Example:

false

data.fee.coin.isFiat

boolean

Whether the coin is a fiat currency

Example:

false

data.fee.count

number

required

Amount of fee paid

Example:

0.001

data.fee.totalWorth

number

required

Total worth of the fee in USD

Example:

25.5

data.fee.price

number

required

Price per unit of the fee coin in USD

Example:

25500

data.fee.toAddress

string

Destination address for the fee transaction

Example:

"0x42382d7853beb8d0ec968de4184a6a3c89cf6b5f"

data.fee.fromAddress

string

Source address for the fee transaction

Example:

"0x8ac77cbf06b44ec918e4ed99698e83a0be222e0e"

data.portfolioInfo

object

required

Information about the portfolio where the transaction occurred

Show child attributes

data.portfolioInfo.name

string

required

Name of the portfolio or exchange where the transaction occurred

Example:

"KuCoin Spot"

data.portfolioInfo.icon

string

required

URL to the portfolio or exchange icon

Example:

"https://static.coinstats.app/portfolio_images/kucoin_dark.png"

data.coinData

object

Main coin data for the transaction (optional for some transaction types)

Show child attributes

data.coinData.identifier

string

required

Unique identifier for the coin in the transaction

Example:

"pepe"

data.coinData.count

number

required

Amount of coins involved in the transaction (can be negative)

Example:

596062

data.coinData.symbol

string

required

Trading symbol of the coin

Example:

"PEPE"

data.coinData.totalWorth

number

required

Total worth of the coins at transaction time in USD

Example:

6.06791116

data.coinData.currentValue

number

required

Current market value of the coins in USD

Example:

5.851540654

data.transfers

object[]

List of transfers involved in the transaction (e.g., coins received/sent)

Show child attributes

data.transfers.transferType

enum<string>

required

Type of transfer operation

Available options:

Received,

Sent

Example:

"Received"

data.transfers.items

object[]

required

List of items involved in the transfer

Show child attributes

data.transfers.items.coin

object

required

Information about the coin being transferred

Show child attributes

data.transfers.items.coin.rank

number

required

Market rank of the coin

Example:

2

data.transfers.items.coin.identifier

string

required

Unique identifier for the coin

Example:

"ethereum"

data.transfers.items.coin.symbol

string

required

Trading symbol of the coin

Example:

"ETH"

data.transfers.items.coin.name

string

required

Full name of the coin

Example:

"Ethereum"

data.transfers.items.coin.icon

string

required

URL to the coin icon image

Example:

"https://static.coinstats.app/coins/1650455629727.png"

data.transfers.items.coin.priceChange24h

number

required

Price change percentage in the last 24 hours

Example:

-5.74

data.transfers.items.coin.priceChange1h

number

required

Price change percentage in the last 1 hour

Example:

0.1

data.transfers.items.coin.priceChange7d

number

required

Price change percentage in the last 7 days

Example:

1.12

data.transfers.items.coin.volume

number

required

Trading volume in the last 24 hours (USD)

Example:

61315198931.43572

data.transfers.items.coin.isFake

boolean

Whether the coin is identified as fake

Example:

false

data.transfers.items.coin.isFiat

boolean

Whether the coin is a fiat currency

Example:

false

data.transfers.items.count

number

Amount of coins transferred (can be negative for outgoing transfers)

Example:

-0.00000544

data.transfers.items.toAddress

string

Destination wallet address

Example:

"0x42382d7853beb8d0ec968de4184a6a3c89cf6b5f"

data.transfers.items.fromAddress

string

Source wallet address

Example:

"0x8ac77cbf06b44ec918e4ed99698e83a0be222e0e"

data.transfers.items.totalWorth

number

Total worth of the transferred amount in USD

Example:

0.0000054389555199999995

data.transfers.items.price

number

Price per unit of the coin in USD at the time of transfer

Example:

0.999808

Market Data

Wallet Data

Exchange Connection

NFTs

News

Portfolio

Market Insights

Get Portfolio Transactions

Authorizations

Headers

Query Parameters

Response