Data API

curl -sS https://YOUR-GATEWAY-DOMAIN/api/v1/network/data/wallet/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?chain_id=1 \
  -H "Authorization: Bearer cs_live_xxx" \
  -H "Accept: application/json"

# response (excerpt)
# {
#   "code": 1,
#   "data": {
#     "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
#     "chain_id": 1,
#     "block_number": 21384022,
#     "collected_at": "2026-10-26T15:04:05Z",
#     "native": { "symbol": "ETH", "decimals": 18, "raw": "1234500000000000000" },
#     "tokens": [
#       { "contract": "0xa0b8…eb48", "symbol": "USDC", "decimals": 6, "raw": "2500000000" }
#     ]
#   }
# }

const CS_KEY = process.env.CS_API_KEY;   // cs_live_xxx — server side only
const BASE = 'https://YOUR-GATEWAY-DOMAIN';

async function getWalletAssets(address, chainId = 1) {
  const url = `${BASE}/api/v1/network/data/wallet/${address}?chain_id=${chainId}`;
  const res = await fetch(url, {
    headers: { 'Authorization': `Bearer ${CS_KEY}`, 'Accept': 'application/json' }
  });
  const payload = await res.json();

  if (payload.code !== 1) {
    // error code → user-facing message; 400016 means rate limited, so back off for the given seconds
    const retryAfter = res.headers.get('Retry-After');
    throw new Error(`request failed (${payload.code}): ${payload.message}`
      + (retryAfter ? `; retry in ${retryAfter} seconds` : ''));
  }

  // always use decimal strings for amounts to avoid floating-point rounding
  return payload.data.tokens.map((t) => ({
    symbol: t.symbol,
    amount: t.raw,          // raw integer; format with decimals only when displaying
    decimals: t.decimals
  }));
}

import os
import requests

CS_KEY = os.environ["CS_API_KEY"]          # cs_live_xxx — server side only
BASE = "https://YOUR-GATEWAY-DOMAIN"

def transactions(address, chain_id=1, page=1, limit=20):
    resp = requests.get(
        f"{BASE}/api/v1/network/data/transactions/{address}",
        params={"chain_id": chain_id, "page": page, "limit": limit},
        headers={"Authorization": f"Bearer {CS_KEY}"},
        timeout=15,
    )
    payload = resp.json()
    if payload.get("code") != 1:
        # do not swallow errors: rethrow with the server message
        raise RuntimeError(f"request failed ({payload.get('code')}): {payload.get('message')}")
    data = payload["data"]
    return data["items"], data["total"]