Skip to content

Common - Chains Catalog ​

Retrieve the catalog of supported blockchain networks and cryptocurrency assets available on the SureLink Gateway. Call this endpoint to obtain valid chain codes prior to initiating crypto deposit or withdrawal orders.


1. List Supported Chains ​

GET /api/v1/chains

Headers ​

Standard HMAC authentication headers (X-Api-Key, X-Timestamp, X-Nonce, X-Signature).

Query Parameters ​

ParameterTypeRequiredDefaultDescription
assetstringNoUSDTFilter by cryptocurrency symbol (e.g., USDT)

Request Example ​

bash
curl -X GET "https://api-sandbox.surelink.io/api/v1/chains?asset=USDT" \
  -H "X-Api-Key: mch_key_your_api_key" \
  -H "X-Timestamp: 1715000000000" \
  -H "X-Nonce: 9f8e7d6c5b4a392817263544a1b2c3d4" \
  -H "X-Signature: c8b9...f01"
typescript
import { sendSignedRequest } from './signer';

const result = await sendSignedRequest({
  apiKey: 'mch_key_...',
  apiSecret: 'sec_...',
  method: 'GET',
  url: 'https://api-sandbox.surelink.io/api/v1/chains?asset=USDT'
});
console.log(result.items);

Response ​

  • Status Code: 200 OK
json
{
  "items": [
    {
      "code": "TRON",
      "name": "Tron (TRC20)",
      "protocol": "TRC20"
    },
    {
      "code": "ETH",
      "name": "Ethereum (ERC20)",
      "protocol": "ERC20"
    },
    {
      "code": "BSC",
      "name": "BNB Smart Chain (BEP20)",
      "protocol": "BEP20"
    },
    {
      "code": "ARBITRUM",
      "name": "Arbitrum One",
      "protocol": "ERC20"
    },
    {
      "code": "POLYGON",
      "name": "Polygon PoS",
      "protocol": "ERC20"
    }
  ]
}

Field Descriptions ​

FieldTypeDescription
itemsArray<ChainOption>Array of supported chain configurations
items[].codestringChain code identifier (pass into chain on order creation)
items[].namestringHuman-readable network display name
items[].protocolstringToken standard protocol (TRC20, ERC20, BEP20, etc.)