FAQ

// Error handling example
async function handleApiError(error) {
  if (error.status === 429) {
    // Rate limited, wait and retry
    await sleep(1000);
    return retry();
  } else if (error.status === 403) {
    // Quota exhausted, need to purchase additional quota
    console.error('Quota exhausted, please purchase additional quota in Dashboard');
  }
}

class ChainStreamWebSocket {
  constructor(baseUrl, accessToken) {
    this.baseUrl = baseUrl;
    this.accessToken = accessToken;
    this.reconnectDelay = 1000;
    this.maxReconnectDelay = 30000;
    this.connect();
  }

  connect() {
    // Pass token via URL parameter
    const url = `${this.baseUrl}?token=${this.accessToken}`;
    this.ws = new WebSocket(url);
    this.ws.onopen = () => {
      console.log('Connected');
      this.reconnectDelay = 1000; // Reset delay
    };
    this.ws.onclose = () => {
      console.log('Disconnected, reconnecting...');
      setTimeout(() => this.connect(), this.reconnectDelay);
      // Exponential backoff
      this.reconnectDelay = Math.min(
        this.reconnectDelay * 2,
        this.maxReconnectDelay
      );
    };
    this.ws.onerror = (error) => {
      console.error('WebSocket error:', error);
    };
  }
}

{
  "chain": "solana",
  "address": "So11111111111111111111111111111111111111112",
  "name": "Wrapped SOL",
  "symbol": "SOL",
  "decimals": 9,
  "price": 95.42
}

{
  "error": {
    "code": "INVALID_TOKEN",
    "message": "Token not found"
  }
}

curl -v "https://api.chainstream.io/v1/token/{chain}/{address}/metadata" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

curl -X POST "https://api.chainstream.io/v1/kya/address/verify" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "So11111111111111111111111111111111111111112",
    "chain": "sol"
  }'

{
  "address": "So11111111111111111111111111111111111111112",
  "risk": "Low",
  "status": "COMPLETE",
  "address_type": "PRIVATE_WALLET",
  "risk_exposures": [
    {
      "label": "sanctioned entity",
      "severity": "Severe",
      "type": "indirect",
      "amount": 372262.76,
      "percentage": 0.6
    },
    {
      "label": "bridge",
      "severity": "Info",
      "type": "indirect",
      "amount": 816082.22,
      "percentage": 1.3
    }
  ]
}