Query Contract Information

Endpoint: /v1/futures/symbols

Request Parameters

None

Method: GET

Example

Bash

curl -X GET "https://oapi.websea.com/v1/futures/symbols?symbol=BTC-USDT"

Query Parameters

Parameter	Required	Type	Example	Description
symbol	No	string	BTC-USDT	Trading pair

Response Parameters

Parameter	Required	Type	Example	Description
errno	Yes	int	0	Status code
errmsg	Yes	string	success	Status message
result	Yes	array	See example	Result list

Result Fields

Parameter	Required	Type	Example	Description
id	Yes	int	11	Trading pair ID
symbol	Yes	string	BTC-USDT	Trading pair
contract_size	Yes	float	1	Contract face value, i.e., USD value per contract
base_currency	Yes	string	BTC	Base currency
quote_currency	Yes	string	USDT	Quote currency
min_size	Yes	float	0.0000001	Minimum order quantity
max_size	Yes	float	10000	Maximum order quantity
min_price	Yes	float	0.001	Minimum order price
max_price	Yes	float	1000	Maximum order price
maker_fee	Yes	float	0.002	Maker fee rate (range: 0–1, e.g. 0.1 = 10%)
taker_fee	Yes	float	0.002	Taker fee rate (range: 0–1, e.g. 0.01 = 1%)

Response Example

JSON

{
    "errno": 0,
    "errmsg": "success",
    "result": [
        {
            "id": 1223,
            "symbol": "BTC-USDT",
            "base_currency": "BTC",
            "quote_currency": "USDT",
            "min_size": 0.0000001,
            "max_size": 10000,
            "min_price": 0.001,
            "max_price": 1000,
            "maker_fee": 0.002,
            "taker_fee": 0.002
        },
        {
            "id": 1223,
            "symbol": "EOS-USDT",
            "base_currency": "EOS",
            "quote_currency": "USDT",
            "min_size": 0.0000001,
            "max_size": 10000,
            "min_price": 0.001,
            "max_price": 1000,
            "maker_fee": 0.002,
            "taker_fee": 0.002
        }
    ]
}