ritmex-bot/docs/binance/binance-spot/testnet_rest-api_general-endpoints.md

title, source, fetched_at

title	source	fetched_at
General endpoints | Binance Open Platform	https://developers.binance.com/docs/binance-spot-api-docs/testnet/rest-api/general-endpoints	2026-02-26T10:38:10.484Z

Test connectivity​

GET /api/v3/ping

Test connectivity to the Rest API.

Weight: 1

Parameters: NONE

Data Source: Memory

Response:

{}

Check server time​

GET /api/v3/time

Test connectivity to the Rest API and get the current server time.

Weight: 1

Parameters: NONE

Data Source: Memory

Response:

{    "serverTime": 1499827319559}

Exchange information​

GET /api/v3/exchangeInfo

Current exchange trading rules and symbol information

Weight: 20

Parameters:

Name

Type

Mandatory

Description

symbol

STRING

No

Example: curl -X GET "https://api.binance.com/api/v3/exchangeInfo?symbol=BNBBTC"

symbols

ARRAY OF STRING

No

Examples: curl -X GET "https://api.binance.com/api/v3/exchangeInfo?symbols=%5B%22BNBBTC%22,%22BTCUSDT%22%5D"
or
curl -g -X GET 'https://api.binance.com/api/v3/exchangeInfo?symbols=["BTCUSDT","BNBBTC"]'

permissions

ENUM

No

Examples: curl -X GET "https://api.binance.com/api/v3/exchangeInfo?permissions=SPOT"
or
curl -X GET "https://api.binance.com/api/v3/exchangeInfo?permissions=%5B%22MARGIN%22%2C%22LEVERAGED%22%5D"
or
curl -g -X GET 'https://api.binance.com/api/v3/exchangeInfo?permissions=["MARGIN","LEVERAGED"]'

showPermissionSets

BOOLEAN

No

Controls whether the content of the permissionSets field is populated or not. Defaults to true

symbolStatus

ENUM

No

Filters for symbols that have this tradingStatus.
Valid values: TRADING, HALT, BREAK
Cannot be used in combination with symbols or symbol.

Notes:

• If the value provided to symbol or symbols do not exist, the endpoint will throw an error saying the symbol is invalid.
• All parameters are optional.
• permissions can support single or multiple values (e.g. SPOT, ["MARGIN","LEVERAGED"]). This cannot be used in combination with symbol or symbols.
• If permissions parameter not provided, all symbols that have either SPOT, MARGIN, or LEVERAGED permission will be exposed.
  • To display symbols with any permission you need to specify them explicitly in permissions: (e.g. ["SPOT","MARGIN",...].). See Account and Symbol Permissions for the full list.

Examples of Symbol Permissions Interpretation from the Response:

• [["A","B"]] means you may place an order if your account has either permission "A" or permission "B".
• [["A"],["B"]] means you can place an order if your account has permission "A" and permission "B".
• [["A"],["B","C"]] means you can place an order if your account has permission "A" and permission "B" or permission "C". (Inclusive or is applied here, not exclusive or, so your account may have both permission "B" and permission "C".)

Data Source: Memory

Response:

{    "timezone": "UTC",    "serverTime": 1565246363776,    "rateLimits": [        {            // These are defined in the `ENUM definitions` section under `Rate Limiters (rateLimitType)`.            // All limits are optional        }    ],    "exchangeFilters": [        // These are the defined filters in the `Filters` section.        // All filters are optional.    ],    "symbols": [        {            "symbol": "ETHBTC",            "status": "TRADING",            "baseAsset": "ETH",            "baseAssetPrecision": 8,            "quoteAsset": "BTC",            "quotePrecision": 8,     // will be removed in future api versions (v4+)            "quoteAssetPrecision": 8,            "baseCommissionPrecision": 8,            "quoteCommissionPrecision": 8,            "orderTypes": [                "LIMIT",                "LIMIT_MAKER",                "MARKET",                "STOP_LOSS",                "STOP_LOSS_LIMIT",                "TAKE_PROFIT",                "TAKE_PROFIT_LIMIT"            ],            "icebergAllowed": true,            "ocoAllowed": true,            "otoAllowed": true,            "opoAllowed": true,            "quoteOrderQtyMarketAllowed": true,            "allowTrailingStop": false,            "cancelReplaceAllowed": false,            "amendAllowed": false,            "pegInstructionsAllowed": true,            "isSpotTradingAllowed": true,            "isMarginTradingAllowed": true,            "filters": [                // These are defined in the Filters section.                // All filters are optional            ],            "permissions": [],            "permissionSets": [["SPOT", "MARGIN"]],            "defaultSelfTradePreventionMode": "NONE",            "allowedSelfTradePreventionModes": ["NONE"]        }    ],    // Optional field. Present only when SOR is available.    // https://github.com/binance/binance-spot-api-docs/blob/master/faqs/sor_faq.md    "sors": [        {            "baseAsset": "BTC",            "symbols": ["BTCUSDT", "BTCUSDC"]        }    ]}

• Test connectivity
• Check server time
• Exchange information