Skip to main content

Chains API

If you want to build a custom chain picker instead of using the SDK component, hit these endpoints directly.

GET /v1/chains​

Public list of every chain HelaMesh supports globally. No auth required. Useful for marketing pages or docs.

curl https://api.helamesh.com/v1/chains
200 OK
{
  "chains": [
    {
      "network": "BSC",
      "displayName": "BNB Smart Chain",
      "tokenSymbol": "USDT",
      "tokenStandard": "BEP20",
      "chainLogoUrl": "https://pay.helamesh.com/logos/chains/bsc.png",
      "tokenLogoUrl": "https://pay.helamesh.com/logos/tokens/usdt.png",
      "estimatedFeeUsd": "0.10",
      "estimatedConfirmationSeconds": 45,
      "tagline": "Cheapest — recommended"
    },
    {
      "network": "TRON",
      "displayName": "TRON",
      "tokenSymbol": "USDT",
      "tokenStandard": "TRC20",
      "chainLogoUrl": "https://pay.helamesh.com/logos/chains/tron.png",
      "tokenLogoUrl": "https://pay.helamesh.com/logos/tokens/usdt.png",
      "estimatedFeeUsd": "0.30",
      "estimatedConfirmationSeconds": 60,
      "tagline": "Most common for Binance users"
    }
  ]
}

GET /v1/chains/client/:clientId​

Returns only the chains this specific client can receive on. A client with only a TRON address configured gets [TRON]. A client with both gets [BSC, TRON]. Requires the publishable key — browser-safe.

curl "https://api.helamesh.com/v1/chains/client/CLIENT_ID?pk=pk_test_YOUR_KEY"
200 OK
{
  "clientId": "65f8a1b2c3d4e5f6a7b8c9d0",
  "clientName": "My Store",
  "environment": "test",
  "availableChains": [
    {
      "network": "BSC",
      "displayName": "BNB Smart Chain",
      "tokenSymbol": "USDT",
      "tokenStandard": "BEP20",
      "chainLogoUrl": "https://pay.helamesh.com/logos/chains/bsc.png",
      "tokenLogoUrl": "https://pay.helamesh.com/logos/tokens/usdt.png",
      "estimatedFeeUsd": "0.10",
      "estimatedConfirmationSeconds": 45,
      "tagline": "Cheapest — recommended"
    }
  ]
}

The environment field tells the browser whether the owning client is in test or live mode — handy for rendering a TEST badge next to the picker without a separate fetch.

Rate limits​

Both endpoints are rate-limited to browser-traffic levels:

  • /v1/chains — 120 req/min per IP
  • /v1/chains/client/:id — 240 req/min per IP

Exceeding these returns 429 Too Many Requests. Back off and retry.