Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.xpaylabs.com/llms.txt

Use this file to discover all available pages before exploring further.

Returns the list of supported symbols (tokens) configured on your gateway. The gateway administrator configures which tokens are available for each blockchain.

Request

GET http://your-gateway:3010/v1/symbol/supportSymbols

Query Parameters

chain
string
Filter by blockchain network. Example: TRON, ETH, BSC, POLYGON. Omit to return symbols for all chains.
symbol
string
Filter by token symbol. Example: USDT, USDC. Omit to return all supported symbols.

cURL

# All supported symbols
curl http://your-gateway:3010/v1/symbol/supportSymbols

# Filter by chain
curl "http://your-gateway:3010/v1/symbol/supportSymbols?chain=TRON"

# Filter by symbol
curl "http://your-gateway:3010/v1/symbol/supportSymbols?symbol=USDT"

Response

A successful request returns HTTP 200 with the R<List<SupportSymbol>> envelope.

SupportSymbol Object

symbol
string
The token symbol, e.g. "USDT", "USDC", "ETH".
chain
string
The blockchain network, e.g. "TRON", "ETH", "BSC".
contractAddress
string | null
The token contract address on this chain. null for native coins (e.g., ETH on Ethereum).
decimals
integer
The number of decimal places for this token. Example: 18 for ERC20 USDT, 6 for TRC20 USDT.

Example Response

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "symbol": "USDT",
      "chain": "TRON",
      "contractAddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "decimals": 6
    },
    {
      "symbol": "USDT",
      "chain": "ETH",
      "contractAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "decimals": 6
    },
    {
      "symbol": "USDC",
      "chain": "ETH",
      "contractAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "decimals": 6
    },
    {
      "symbol": "USDT",
      "chain": "BSC",
      "contractAddress": "0x55d398326f99059fF775485246999027B3197955",
      "decimals": 18
    },
    {
      "symbol": "USDC",
      "chain": "SUI",
      "contractAddress": null,
      "decimals": 6
    }
  ]
}