Skip to main content
PATCH
/
wallet
/
transactions
Initiate syncing process to update transaction data.
curl --request PATCH \
  --url https://openapiv1.coinstats.app/wallet/transactions \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "wallets": [
    {
      "address": "0x123456789abcdef",
      "connectionId": "ethereum"
    },
    {
      "address": "0x987654321fedcba",
      "blockchain": "binance_smart"
    }
  ]
}
'
{
  "status": "synced"
}

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.

50 credits per request
In Query field “connectionId”: credits are multiplied by the number of values.
If the value of “connectionId” in Query is “all”, multiplier is 500 credits.
In Query field “blockchain”: credits are multiplied by the number of values.
If the value of “blockchain” in Query is “all”, multiplier is 500 credits.
In Body field “wallets”: credits are multiplied by the number of values.
If the value of “wallets” in Body is “all”, multiplier is 500 credits.
In Body field “wallets”: credits are multiplied by the number of values.
If the value of “wallets” in Body is “all”, multiplier is 500 credits.
Multipliers can be applied multiple times.
Detailed multipliers explanation
Provide query parameters: address plus either connectionId or blockchain.
Example: { address: “0x123…”, connectionId: “ethereum” }
Provide a body with a wallets array, each item having address plus either connectionId or blockchain.
Example: { wallets: [{ address: “0x123…”, connectionId: “ethereum” }, { address: “0x456…”, blockchain: “polygon” }] }

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

​
address
string

Wallet address for single wallet sync

​
connectionId
string

The identifier of connection for single wallet sync, which you received from /wallet/blockchains call response. Can be a single network (e.g., "ethereum") or a comma-separated list of networks or "all" for all connections. Either connectionId or blockchain must be provided. If both are provided, connectionId will be used.

Example:

"base-wallet"

​
blockchain
string

The blockchain network identifier from /wallet/blockchains call response. Can be a single network (e.g., "ethereum") or a comma-separated list of networks (e.g., "ethereum,polygon,binance_smart"). Either connectionId or blockchain must be provided. If both are provided, connectionId will be used.

Example:

"base"

Body

application/json
​
wallets
object[]

Array of wallets to sync transactions for

Example:
[
  {
    "address": "0x123456789abcdef",
    "connectionId": "ethereum"
  },
  {
    "address": "0x987654321fedcba",
    "blockchain": "binance_smart"
  }
]

Response

Start syncing transactions

​
status
enum<string>
required

The current synchronization status of the portfolio

Available options:
syncing,
synced
Example:

"synced"