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"
      }
    }
  ]
}

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.

30 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 300 credits.
Detailed multipliers explanation
Provide address plus either connectionId or blockchain.
Provide wallets parameter in format “connectionId:address,connectionId:address”
  • coinId: Filter transactions by coin
  • txId: Look up a specific transaction by hash
  • page, limit: Pagination (default limit 20, max 100)
  • Returns 409 Conflict if transactions have not been synced yet — call PATCH /wallet/transactions first

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.

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:

"2026-05-08T09:17:04.663Z"

​
to
string<date-time>

Please include the date in ISO 8601 format

Example:

"2026-05-09T11:17:04.663Z"

​
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 identifier of connection from /wallet/blockchains call response. Either connectionId or blockchain must be provided. If both are provided, connectionId will be used. Required if using address parameter.

Example:

"ethereum"

​
blockchain
string

The blockchain network identifier from /wallet/blockchains call response. Either connectionId or blockchain must be provided. If both are provided, connectionId will be used. Required if using address parameter.

Example:

"ethereum"

​
txId
string

Transaction hash to search for a specific transaction.

Example:

"0xc969639a5c08179c32326b5d9e8bb73f34beeb5566b7e7a6a411d38ee4c77ba4"

​
coinId
string

Coin ID to search for a specific coin.

Example:

"bitcoin"

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