Skip to main content
GET
/
wallet
/
transactions
Get transaction data for wallet addresses
curl --request GET \
  --url https://openapiv1.coinstats.app/wallet/transactions \
  --header 'X-API-KEY: <api-key>'
{
  "meta": {
    "page": 1,
    "limit": 10
  },
  "result": [
    {
      "type": "Sent",
      "date": "2025-06-07T11:58:11.000Z",
      "mainContent": {
        "coinIcons": [
          "https://static.coinstats.app/coins/1650455629727.png"
        ],
        "coinAssets": []
      },
      "coinData": {
        "count": -0.00636637,
        "symbol": "ETH",
        "currentValue": 29.21596436513665
      },
      "profitLoss": {
        "profit": -13.414468590167441,
        "profitPercent": -84.44241338814263,
        "currentValue": 29.21596436513665
      },
      "transactions": [
        {
          "action": "Sent",
          "items": [
            {
              "id": "publicApi_0_0x3f1A9B2c5E4C7d9F8E23bC19A8A6c77B10e62E5dGROUP436a0bddwithdraw",
              "count": -0.00636637,
              "totalWorth": 15.88593699768782,
              "coin": {
                "id": "ethereum",
                "name": "Ethereum",
                "symbol": "ETH",
                "icon": "https://static.coinstats.app/coins/1650455629727.png"
              }
            }
          ]
        }
      ],
      "fee": {
        "coin": {
          "id": "ethereum",
          "name": "Ethereum",
          "symbol": "ETH",
          "icon": "https://static.coinstats.app/coins/1650455629727.png"
        },
        "count": 0.000033840249219,
        "totalWorth": 0.08444122271861178
      },
      "hash": {
        "id": "0xc969639a5c08179c32326b5d9e8bb73f34beeb5566b7e7a6a411d38ee4c77ba4",
        "explorerUrl": "https://etherscan.io/tx/0xc969639a5c08179c32326b5d9e8bb73f34beeb5566b7e7a6a411d38ee4c77ba4"
      }
    }
  ]
}
40 credits per request
In Query field “wallets”: credits are multiplied by the number of values.
If the value of “wallets” in Query is “all”, multiplier is 400 credits.
Detailed multipliers explanation
Provide address and connectionId separately
Provide wallets parameter in format “connectionId:address,connectionId:address”

Authorizations

​
X-API-KEY
string
header
required

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

Query Parameters

​
page
number

Page number to retrieve (1-based indexing)

Example:

1

​
limit
number

Number of transactions to return per page. Default is 20, min is 1, max is 100.

Example:

20

​
from
string<date-time>

Please include the date in ISO 8601 format

Example:

"2025-10-01T10:37:00.079Z"

​
to
string<date-time>

Please include the date in ISO 8601 format

Example:

"2025-10-02T12:37:00.079Z"

​
currency
string
Example:

"USD"

​
types
string

Comma separated values of (deposit,withdraw,approve,executed,balance,fee)

​
address
string

The wallet address to fetch transactions for. Required if not using wallets parameter.

Example:

"0x1234567890abcdef1234567890abcdef12345678"

​
connectionId
string

The blockchain network identifier obtained from /wallet/blockchains endpoint. Required if using address parameter.

Example:

"ethereum"

​
txId
string

Transaction hash to search for a specific transaction.

Example:

"0xc969639a5c08179c32326b5d9e8bb73f34beeb5566b7e7a6a411d38ee4c77ba4"

​
wallets
string

Comma-separated list of wallet addresses in format "connectionId:address". Use this for querying multiple wallets at once.

Example:

"ethereum:0x1234567890abcdef1234567890abcdef12345678,all:0x4567890abcdef1234567890abcdef1234567890abc"

Response

Get wallet transactions

​
meta
object
required

Pagination metadata including total count and current page information

Example:
{ "page": 1, "limit": 10 }
​
result
object[]
required

Array of transaction records

Example:
[
  {
    "type": "Sent",
    "date": "2025-06-07T11:58:11.000Z",
    "mainContent": {
      "coinIcons": [
        "https://static.coinstats.app/coins/1650455629727.png"
      ],
      "coinAssets": []
    },
    "coinData": {
      "count": -0.00636637,
      "symbol": "ETH",
      "currentValue": 29.21596436513665
    },
    "profitLoss": {
      "profit": -13.414468590167441,
      "profitPercent": -84.44241338814263,
      "currentValue": 29.21596436513665
    },
    "transactions": [
      {
        "action": "Sent",
        "items": [
          {
            "id": "publicApi_0_0x3f1A9B2c5E4C7d9F8E23bC19A8A6c77B10e62E5dGROUP436a0bddwithdraw",
            "count": -0.00636637,
            "totalWorth": 15.88593699768782,
            "coin": {
              "id": "ethereum",
              "name": "Ethereum",
              "symbol": "ETH",
              "icon": "https://static.coinstats.app/coins/1650455629727.png"
            }
          }
        ]
      }
    ],
    "fee": {
      "coin": {
        "id": "ethereum",
        "name": "Ethereum",
        "symbol": "ETH",
        "icon": "https://static.coinstats.app/coins/1650455629727.png"
      },
      "count": 0.000033840249219,
      "totalWorth": 0.08444122271861178
    },
    "hash": {
      "id": "0xc969639a5c08179c32326b5d9e8bb73f34beeb5566b7e7a6a411d38ee4c77ba4",
      "explorerUrl": "https://etherscan.io/tx/0xc969639a5c08179c32326b5d9e8bb73f34beeb5566b7e7a6a411d38ee4c77ba4"
    }
  }
]
⌘I