Get Wallet Sync Status

cURL

curl --request GET \
  --url 'https://api.coinstats.app/v1/wallet/status?address=0x742d35Cc6634C0532925a3b844Bc454e4438f44e&blockchain=ethereum' \
  --header 'X-API-KEY: <api-key>'

import requests

url = "https://api.coinstats.app/v1/wallet/status?address=0x742d35Cc6634C0532925a3b844Bc454e4438f44e&blockchain=ethereum"

headers = {"X-API-KEY": "<api-key>"}

response = requests.request("GET", url, headers=headers)

print(response.json())

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://api.coinstats.app/v1/wallet/status?address=0x742d35Cc6634C0532925a3b844Bc454e4438f44e&blockchain=ethereum', options)
  .then((response) => response.json())
  .then((response) => console.log(response))
  .catch((err) => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.coinstats.app/v1/wallet/status?address=0x742d35Cc6634C0532925a3b844Bc454e4438f44e&blockchain=ethereum",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {

	url := "https://api.coinstats.app/v1/wallet/status?address=0x742d35Cc6634C0532925a3b844Bc454e4438f44e&blockchain=ethereum"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))
}

HttpResponse<String> response = Unirest.get("https://api.coinstats.app/v1/wallet/status?address=0x742d35Cc6634C0532925a3b844Bc454e4438f44e&blockchain=ethereum")
  .header("X-API-KEY", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.coinstats.app/v1/wallet/status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "status": "synced"
}

{
  "statusCode": 400,
  "message": "Bad Request",
  "requestId": "11111111-2222-3333-4444-555555555555",
  "path": "<requested-endpoint>"
}

{
  "statusCode": 401,
  "message": "Unauthorized",
  "requestId": "11111111-2222-3333-4444-555555555555",
  "path": "<requested-endpoint>"
}

{
  "statusCode": 403,
  "message": "Forbidden",
  "requestId": "11111111-2222-3333-4444-555555555555",
  "path": "<requested-endpoint>"
}

{
  "statusCode": 404,
  "message": "Not Found",
  "requestId": "11111111-2222-3333-4444-555555555555",
  "path": "<requested-endpoint>"
}

{
  "statusCode": 409,
  "message": "Transactions not synced",
  "requestId": "11111111-2222-3333-4444-555555555555",
  "path": "<requested-endpoint>"
}

{
  "statusCode": 429,
  "message": "Rate limit exceeded",
  "requestId": "11111111-2222-3333-4444-555555555555",
  "path": "<requested-endpoint>"
}

{
  "statusCode": 503,
  "message": "Service Unavailable. Please Contact Support"
}

GET

wallet

status

cURL

curl --request GET \
  --url 'https://api.coinstats.app/v1/wallet/status?address=0x742d35Cc6634C0532925a3b844Bc454e4438f44e&blockchain=ethereum' \
  --header 'X-API-KEY: <api-key>'

import requests

url = "https://api.coinstats.app/v1/wallet/status?address=0x742d35Cc6634C0532925a3b844Bc454e4438f44e&blockchain=ethereum"

headers = {"X-API-KEY": "<api-key>"}

response = requests.request("GET", url, headers=headers)

print(response.json())

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://api.coinstats.app/v1/wallet/status?address=0x742d35Cc6634C0532925a3b844Bc454e4438f44e&blockchain=ethereum', options)
  .then((response) => response.json())
  .then((response) => console.log(response))
  .catch((err) => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.coinstats.app/v1/wallet/status?address=0x742d35Cc6634C0532925a3b844Bc454e4438f44e&blockchain=ethereum",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {

	url := "https://api.coinstats.app/v1/wallet/status?address=0x742d35Cc6634C0532925a3b844Bc454e4438f44e&blockchain=ethereum"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))
}

HttpResponse<String> response = Unirest.get("https://api.coinstats.app/v1/wallet/status?address=0x742d35Cc6634C0532925a3b844Bc454e4438f44e&blockchain=ethereum")
  .header("X-API-KEY", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.coinstats.app/v1/wallet/status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "status": "synced"
}

{
  "statusCode": 400,
  "message": "Bad Request",
  "requestId": "11111111-2222-3333-4444-555555555555",
  "path": "<requested-endpoint>"
}

{
  "statusCode": 401,
  "message": "Unauthorized",
  "requestId": "11111111-2222-3333-4444-555555555555",
  "path": "<requested-endpoint>"
}

{
  "statusCode": 403,
  "message": "Forbidden",
  "requestId": "11111111-2222-3333-4444-555555555555",
  "path": "<requested-endpoint>"
}

{
  "statusCode": 404,
  "message": "Not Found",
  "requestId": "11111111-2222-3333-4444-555555555555",
  "path": "<requested-endpoint>"
}

{
  "statusCode": 409,
  "message": "Transactions not synced",
  "requestId": "11111111-2222-3333-4444-555555555555",
  "path": "<requested-endpoint>"
}

{
  "statusCode": 429,
  "message": "Rate limit exceeded",
  "requestId": "11111111-2222-3333-4444-555555555555",
  "path": "<requested-endpoint>"
}

{
  "statusCode": 503,
  "message": "Service Unavailable. Please Contact Support"
}

3 credits per request

Multipliers

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

Required

address: Wallet address.
One of connectionId or blockchain (if both provided, connectionId is used).

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. If both connectionId and blockchain are provided, connectionId will be used. On the balance endpoints both may be omitted, in which case the networks are detected from the address: an EVM address (0x… or ENS) is queried on every EVM chain and billed like "all", any other address is queried on the first network its format is valid for. 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. If both connectionId and blockchain are provided, connectionId will be used. On the balance endpoints both may be omitted, in which case the networks are detected from the address: an EVM address (0x… or ENS) is queried on every EVM chain and billed like "all", any other address is queried on the first network its format is valid for. 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"

⌘I

Market Data

Wallets & Portfolios

Prediction Markets

Account

Get Wallet Sync Status

Authorizations

Query Parameters

Response