HTTP API: Listing
All listing endpoints require authentication.
GET /v1/listing/pairs
Query parameters:
| Param | Type | Required | Notes |
|---|---|---|---|
chain_id |
uint64 | no | 0 or omitted means all chains |
Response data: pairs[].
Each pair:
| Field | Type | Notes |
|---|---|---|
pair_id |
string | Pair identifier |
chain_id |
uint64 | Chain ID |
pair_symbol |
string | Example: WBNB-USDT |
base_token |
TokenInfo | Base token metadata |
quote_token |
TokenInfo | Quote token metadata |
is_enabled |
bool | Whether enabled |
fee_rate |
uint64 | bps |
fee_to |
string | Fee recipient; empty means no fee |
Example:
curl "{rfq-api-base-url}/v1/listing/pairs?chain_id=97" \
-H 'Authorization: Bearer YOUR_JWT_TOKEN'
GET /v1/listing/tokens
Query parameters:
| Param | Type | Required | Notes |
|---|---|---|---|
chain_id |
uint64 | no | 0 or omitted means all chains |
token_address |
string | no | If set, returns tokens that can pair with this token (enabled pairs only) |
Response data: tokens[] (TokenInfo).
TokenInfo:
| Field | Type | Notes |
|---|---|---|
token_address |
string | Zero address means native token |
token_symbol |
string | Symbol |
token_name |
string | Name |
decimals |
uint8 | Decimals |
logo_url |
string | Logo |
total_supply |
string | Decimal string |
wrapped_token |
string | Wrapped address (may be empty) |
chain_id |
uint64 | Chain ID |
Examples:
curl "{rfq-api-base-url}/v1/listing/tokens?chain_id=97" \
-H 'Authorization: Bearer YOUR_JWT_TOKEN'
curl "{rfq-api-base-url}/v1/listing/tokens?chain_id=97&token_address=0xae13d989daC2f0dEbFf460aC112a837C89BAa7cd" \
-H 'Authorization: Bearer YOUR_JWT_TOKEN'