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 Sync Status
Get the syncing status of the provided wallet address with the blockchain network.
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"
}Multipliers
Multipliers
Required
Required
- address: Wallet address.
- One of connectionId or blockchain (if both provided, connectionId is used).
Authorizations
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
The blockchain wallet address to query balances for
"0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
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.
"base-wallet"
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.
"base"
Response
Get wallet sync status
The current synchronization status of the portfolio
syncing, synced "synced"
Was this page helpful?