> ## 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.

# List Supported Symbols | GET /v1/symbol/supportSymbols

> Retrieve the list of supported blockchain tokens configured on your gateway. Filter by chain or symbol to narrow results.

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:180/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

```bash theme={null}
# All supported symbols
curl http://your-gateway:180/v1/symbol/supportSymbols

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

# Filter by symbol
curl "http://your-gateway:180/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: `6` for ERC20 USDT, `6` for TRC20 USDT, `18` for BEP20 USDT.

### Example Response

```json theme={null}
{
  "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
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.