Copy page

General Info

This module documents the Stocks Trading REST API. Base URL, HMAC / Ed25519 signing, timestamps, recvWindow, rate limits, and the sapi error envelope are identical to other SAPI endpoint families — see the root General Info for those.

This page lists only what is specific to the Stocks Trading module.

Disclaimer Prerequisite

Before placing orders, the account must accept the US equity disclaimer via POST /account/disclaimer. Orders placed before acceptance are rejected with 486410 (Please sign the trading disclaimer before placing an order).

Rate Limits

In addition to the shared SAPI weight / IP limits, the following endpoints carry a per-UID request-rate cap:

Endpoint	Limit
POST /order/place	200 requests / min (UID)
POST /tokenized/mint	50 requests / min (UID)
POST /tokenized/redeem	50 requests / min (UID)

URL Prefix

All endpoints in this module share the prefix:

Code
/sapi/v1/equity/

Symbol Format

• symbol is always a plain US-equity ticker, UPPERCASE.
• Valid: AAPL, NVDA, TSLA, SPY, QQQ.
• Invalid: EQ_AAPL, AAPLUSDT, aapl.
• Tickers are resolved against the active-symbol list. Unknown-ticker behavior is endpoint-specific: /order/place and /tokenized/mint return -26004; /market/exchangeInfo returns an empty symbols array; /market/quote returns an empty response body.

Quote Asset

• Default is USDC when quoteAsset is omitted in a /order/place request.
• The service enforces a server-side allow-set; values outside the allow-set are rejected.

Prices

• All price fields are quoted in USD implicitly.
• Limit prices are capped at 2 decimal places; orders with deeper precision are rejected at validation.

Timestamps

• All timestamp fields in requests and responses use milliseconds since Unix epoch.
• timestamp in each signed request is the caller's current time; recvWindow applies the same as other SAPI endpoints (default 5000 ms, max 60000 ms).

Enum Contract

• All enum string values are UPPERCASE on both request and response (BUY / SELL, MARKET / LIMIT, FILLED / CANCELED, RTH / EXTENDED / 24H).
• See Common Definition for the full enum sets.

Fees

• For LIMIT BUY orders, the service automatically computes the commission fee and includes it in the funds locked at placement time. Callers submit price and quantity only — no fee field is exposed on the request surface.
• Realized commission fees are reflected in the fee field of the order / trade history and order detail responses.