Skip to main content
GET
/
wallet
/
status
Get the syncing status of the provided wallet address with the blockchain network.
curl --request GET \
  --url https://openapiv1.coinstats.app/wallet/status \
  --header 'X-API-KEY: <api-key>'
{
  "status": "synced"
}
3 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 30 credits.
In Query field “blockchain”: credits are multiplied by the number of values.
If the value of “blockchain” in Query is “all”, multiplier is 30 credits.
Multipliers can be applied multiple times.
Detailed multipliers explanation
  • address: Wallet address.
  • connectionId: Identifier of the connection (chain) for the address.

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
required

The blockchain wallet address to query balances for

Example:

"0x742d35Cc6634C0532925a3b844Bc454e4438f44e"

​
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. Accepts "all" — top-tier EVM chains (ethereum, binacesmartchain, base-wallet, polygon-wallet, arbitrum-wallet, optimism-wallet, avalanche-wallet, hyperevm-wallet, monad-wallet, plasma-wallet) are always included; other chains are subject to a per-chain latency limit and may be skipped from the response. Use "forceall" instead to wait for every supported chain regardless of latency.

Example:

"base-wallet"

​
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. Accepts "all" — top-tier EVM chains (ethereum, binacesmartchain, base-wallet, polygon-wallet, arbitrum-wallet, optimism-wallet, avalanche-wallet, hyperevm-wallet, monad-wallet, plasma-wallet) are always included; other chains are subject to a per-chain latency limit and may be skipped from the response. Use "forceall" instead to wait for every supported chain regardless of latency.

Example:

"base"

Response

Get wallet sync status

​
status
enum<string>
required

The current synchronization status of the portfolio

Available options:
syncing,
synced
Example:

"synced"