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"
}
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
{ wallets: [{ address: “0x123…”, connectionId: “ethereum” }] }
  • Single-wallet form: query params address + connectionId.
  • Multi-wallet form: JSON body with wallets array (each item \{ address, connectionId \}).
  • At least one wallet must be provided.

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"