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: “0x123…”, connectionId: “ethereum” }
Provide a body with
{ wallets: [{ address: “0x123…”, connectionId: “ethereum” }] }

Authorizations

​
X-API-KEY
string
header
required

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

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"