REST 参考¶
交互式参考由 OpenAPI 3.1 生成:
specs/openapi/openapi.yaml
自 postman/Polaris-OpenAPI-Order.postman_collection.json 种子生成,并与 ptrader-api-gateway 控制器对齐。
草稿 Schema
多数 200 响应仍为开放对象。Postman 请求示例请视为示意,待 DTO schema 补全。进度见 待确认清单 与 OpenAPI 缺口。
OpenAPI 正文语言
下方嵌入的 OpenAPI 操作摘要目前为英文(与 Postman / 代码标识一致)。路径、参数名、枚举值保持 API 原文,请勿翻译字段名。
分组¶
| Tag | 控制器(证据) |
|---|---|
| Public | GeneralApiController、UserDataApiController.queryUserIp |
| Market Data | MktDataApiController |
| Spot Trading | OrderApiController |
| User Data Stream | UserDataApiController(listenKey) |
| Account | AccountApiController、BalanceApiController、AssetApiController |
| Wallet | WalletApiController |
| Convert | ConvertOpenApiController |
| Fiat | FiatOpenApiController、FiatOpenApiV2Controller |
| Fiat Migration | FiatMigrationApiController |
| Sub-Account | SubAccountController |
| Transfer | TransferApiController |
| Margin & Fund Collect | MarginApiController、FundCollectController |
| Payment Request | PaymentRequestController |
现货订单类型与 TIF¶
证据:NewOrderApiRequest + 鉴权文档下单章节。
| 字段 | 取值 |
|---|---|
type |
LIMIT、MARKET、LIMIT_MAKER、STOP_LOSS、STOP_LOSS_LIMIT、TAKE_PROFIT、TAKE_PROFIT_LIMIT |
timeInForce |
GTC(默认)、IOC、FOK |
side |
BUY、SELL |
newOrderRespType |
ACK、RESULT、FULL |
stpFlag |
STP 枚举;鉴权文档默认记为 CB |
OpenAPI¶
源文件(仓库内亦见 specs/openapi/openapi.yaml):
Polaris Public OpenAPI 0.1.0-draft¶
Polaris public REST API (api-gateway).
Scope = postman/Polaris-OpenAPI-Order.postman_collection.json. Behavior authority = ptrader-api-gateway. Excluded: merchant-api, create-api-key-tool, admin/BFF.
Servers¶
| Description | URL |
|---|---|
| Dev (Postman openapiHost) | https://api-gateway-scb.dev.pcrypto.com |
| [NEEDS-CONFIRMATION: QA/Prod hosts] | https://{host} |
Account¶
GET /openapi/account/v3/crypto-accounts¶
crypto-accounts v3
Description
Source: Postman Polaris-OpenAPI-Order / Account-Asset / crypto-accounts v3.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
currency |
query | string | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
GET /openapi/v1/account¶
account
Description
Source: Postman Polaris-OpenAPI-Order / Account-Asset / account.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
GET /openapi/v1/asset/tradeFee¶
tradeFee
Description
Source: Postman Polaris-OpenAPI-Order / Account-Asset / tradeFee.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
symbol |
query | string | No | ||
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
GET /openapi/v1/asset/transaction/history¶
transaction history
Description
Source: Postman Polaris-OpenAPI-Order / Account-Asset / transaction history.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
pageNum |
query | integer | No | ||
pageSize |
query | integer | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script | |
tokenId |
query | string | No |
Responses
Convert¶
POST /openapi/convert/v1/accept-quote¶
accept quote
Description
Source: Postman Polaris-OpenAPI-Order / Convert / accept quote.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Request body
Responses
POST /openapi/convert/v1/get-quote¶
get quote
Description
Source: Postman Polaris-OpenAPI-Order / Convert / get quote.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Request body
Responses
POST /openapi/convert/v1/get-supported-trading-pairs¶
supported pairs
Description
Source: Postman Polaris-OpenAPI-Order / Convert / supported pairs.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Request body
Responses
POST /openapi/convert/v1/query-order-history¶
order history
Description
Source: Postman Polaris-OpenAPI-Order / Convert / order history.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Request body
Responses
Fiat¶
POST /openapi/fiat/v1/cash-out¶
cash-out
Description
fiatOnly needWrite — careful
Source: Postman Polaris-OpenAPI-Order / Fiat/Write / cash-out.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Request body
Responses
GET /openapi/fiat/v1/details¶
details
Description
Source: Postman Polaris-OpenAPI-Order / Fiat/Read / details.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
internalOrderId |
query | string | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
GET /openapi/fiat/v1/get_qr_code¶
get_qr_code
Description
Source: Postman Polaris-OpenAPI-Order / Fiat/Read / get_qr_code.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
requestId |
query | string | No | ||
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
GET /openapi/fiat/v1/get_qr_code/static/list¶
static qr list
Description
Source: Postman Polaris-OpenAPI-Order / Fiat/Read / static qr list.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
status |
query | string | No | ||
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
POST /openapi/fiat/v1/history¶
history
Description
Source: Postman Polaris-OpenAPI-Order / Fiat/Write / history.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Request body
Responses
POST /openapi/fiat/v1/support-channel¶
support-channel
Description
Source: Postman Polaris-OpenAPI-Order / Fiat/Write / support-channel.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Request body
Responses
POST /openapi/fiat/v2/history¶
history v2
Description
Source: Postman Polaris-OpenAPI-Order / Fiat/Write / history v2.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Request body
Responses
Fiat Migration¶
GET /openapi/migration/v4/payout-outlet-categories¶
payout-outlet-categories
Description
Source: Postman Polaris-OpenAPI-Order / Fiat-Migration/Read / payout-outlet-categories.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
GET /openapi/migration/v4/payout-outlet-fees¶
payout-outlet-fees
Description
Source: Postman Polaris-OpenAPI-Order / Fiat-Migration/Read / payout-outlet-fees.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
currency |
query | string | No | ||
payment_outlet |
query | string | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
GET /openapi/migration/v4/payout-outlets¶
payout-outlets
Description
Source: Postman Polaris-OpenAPI-Order / Fiat-Migration/Read / payout-outlets.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
POST /openapi/migration/v4/sellorder¶
create sellorder
Description
Fill real sellorder fields per environment; placeholder body
Source: Postman Polaris-OpenAPI-Order / Fiat-Migration/Write / create sellorder.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Request body
Responses
GET /openapi/migration/v4/sellorder¶
list sellorder
Description
Source: Postman Polaris-OpenAPI-Order / Fiat-Migration/Read / list sellorder.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
limit |
query | integer | No | ||
offset |
query | integer | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
GET /openapi/migration/v4/sellorder/{sellOrderId}¶
get sellorder
Description
Source: Postman Polaris-OpenAPI-Order / Fiat-Migration/Read / get sellorder.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
sellOrderId |
path | string | No | ||
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
POST /openapi/migration/v4/validate-field¶
validate-field
Description
Source: Postman Polaris-OpenAPI-Order / Fiat-Migration/Write / validate-field.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Request body
Responses
Market Data¶
GET /openapi/quote/v1/avgPrice¶
avgPrice
Description
Source: Postman Polaris-OpenAPI-Order / Market / avgPrice.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
symbol |
query | string | No |
Responses
GET /openapi/quote/v1/depth¶
depth
Description
Source: Postman Polaris-OpenAPI-Order / Market / depth.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
limit |
query | integer | No | ||
symbol |
query | string | No |
Responses
GET /openapi/quote/v1/klines¶
klines
Description
Source: Postman Polaris-OpenAPI-Order / Market / klines.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
interval |
query | string | No | ||
limit |
query | integer | No | ||
symbol |
query | string | No |
Responses
GET /openapi/quote/v1/ticker/24hr¶
ticker 24hr
Description
Source: Postman Polaris-OpenAPI-Order / Market / ticker 24hr.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
symbol |
query | string | No |
Responses
GET /openapi/quote/v1/ticker/bookTicker¶
bookTicker
Description
Source: Postman Polaris-OpenAPI-Order / Market / bookTicker.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
symbol |
query | string | No |
Responses
GET /openapi/quote/v1/ticker/price¶
ticker price
Description
Source: Postman Polaris-OpenAPI-Order / Market / ticker price.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
symbol |
query | string | No |
Responses
GET /openapi/quote/v1/trades¶
trades
Description
Source: Postman Polaris-OpenAPI-Order / Market / trades.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
limit |
query | integer | No | ||
symbol |
query | string | No |
Responses
Transfer¶
POST /openapi/transfer/v3/transfers¶
create transfer
Description
Source: Postman Polaris-OpenAPI-Order / Transfer/Write / create transfer.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Request body
Responses
GET /openapi/transfer/v3/transfers¶
list transfers
Description
Source: Postman Polaris-OpenAPI-Order / Transfer/Read / list transfers.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
page |
query | integer | No | ||
per_page |
query | integer | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
GET /openapi/transfer/v3/transfers/{transferId}¶
get transfer by id
Description
Source: Postman Polaris-OpenAPI-Order / Transfer/Read / get transfer by id.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script | |
transferId |
path | string | No |
Responses
Public¶
GET /openapi/v1/exchangeInfo¶
exchangeInfo
Description
Source: Postman Polaris-OpenAPI-Order / Public / exchangeInfo.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
symbol |
query | string | No |
Responses
GET /openapi/v1/pairs¶
pairs
Description
Source: Postman Polaris-OpenAPI-Order / Public / pairs.
Responses
GET /openapi/v1/ping¶
ping
Description
Health
Source: Postman Polaris-OpenAPI-Order / Public / ping.
Responses
GET /openapi/v1/time¶
time
Description
Server time
Source: Postman Polaris-OpenAPI-Order / Public / time.
Responses
GET /openapi/v1/user/ip¶
user ip
Description
Source: Postman Polaris-OpenAPI-Order / Public / user ip.
Responses
Margin & Fund Collect¶
POST /openapi/v1/fund-collect/collect-from-sub-account¶
collect-from-sub-account
Description
Source: Postman Polaris-OpenAPI-Order / Margin-FundCollect/FundCollect-Write / collect-from-sub-account.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Request body
Responses
GET /openapi/v1/fund-collect/get-fund-record¶
get-fund-record
Description
Source: Postman Polaris-OpenAPI-Order / Margin-FundCollect/FundCollect-Read / get-fund-record.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
page |
query | integer | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
size |
query | integer | No | ||
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
POST /openapi/v1/margin/transfer¶
margin transfer
Description
Source: Postman Polaris-OpenAPI-Order / Margin-FundCollect/Margin-Write / margin transfer.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Request body
Responses
GET /openapi/v1/margin/transfer/history¶
margin transfer history
Description
Source: Postman Polaris-OpenAPI-Order / Margin-FundCollect/Margin-Read / margin transfer history.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
current |
query | integer | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
size |
query | integer | No | ||
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
Spot Trading¶
GET /openapi/v1/historyOrders¶
history orders
Description
Historical orders.
Source: Postman Polaris-OpenAPI-Order / Signed-Order / history orders.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
limit |
query | integer | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
symbol |
query | string | No | ||
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
GET /openapi/v1/myTrades¶
my trades
Description
Historical trades. symbol required.
Source: Postman Polaris-OpenAPI-Order / Signed-Order / my trades.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
limit |
query | integer | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
symbol |
query | string | No | ||
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
GET /openapi/v1/openOrders¶
open orders
Description
List open orders. symbol optional.
Source: Postman Polaris-OpenAPI-Order / Signed-Order / open orders.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
symbol |
query | string | No | ||
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
DELETE /openapi/v1/openOrders¶
cancel all open orders
Description
Cancel all open orders for symbol. confirmCancelAll must be true.
Source: Postman Polaris-OpenAPI-Order / Signed-Order / cancel all open orders.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
confirmCancelAll |
query | string | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
symbol |
query | string | No | ||
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
GET /openapi/v1/openOrders/all¶
all open orders (whitelist)
Description
All users open orders for symbol. Caller must be in full.order.read.whitelist.
Source: Postman Polaris-OpenAPI-Order / Signed-Order / all open orders (whitelist).
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
symbol |
query | string | No | ||
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
POST /openapi/v1/order¶
place order LIMIT
Description
Place LIMIT order. Params in query. Requires trade-capable API key. Use small size on dev.
Source: Postman Polaris-OpenAPI-Order / Signed-Order / place order LIMIT.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
newOrderRespType |
query | string | No | ||
price |
query | string | No | ||
quantity |
query | string | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
side |
query | string | No | ||
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
symbol |
query | string | No | ||
timeInForce |
query | string | No | ||
timestamp |
query | integer | No | Auto-filled by Pre-request Script | |
type |
query | string | No |
Responses
GET /openapi/v1/order¶
get order
Description
Query one order. orderId or origClientOrderId required.
Source: Postman Polaris-OpenAPI-Order / Signed-Order / get order.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
orderId |
query | string | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
DELETE /openapi/v1/order¶
cancel order
Description
Cancel one order.
Source: Postman Polaris-OpenAPI-Order / Signed-Order / cancel order.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
orderId |
query | string | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
POST /openapi/v1/order/cancelReplace¶
cancelReplace
Description
Atomic cancel+replace. cancelOrderId or cancelOrigClientOrderId.
Source: Postman Polaris-OpenAPI-Order / Signed-Order / cancelReplace.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
cancelOrderId |
query | string | No | ||
cancelReplaceMode |
query | string | No | ||
price |
query | string | No | ||
quantity |
query | string | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
side |
query | string | No | ||
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
symbol |
query | string | No | ||
timeInForce |
query | string | No | ||
timestamp |
query | integer | No | Auto-filled by Pre-request Script | |
type |
query | string | No |
Responses
POST /openapi/v1/order/test¶
order test (validate only)
Description
Validate order params without placing. Returns {}.
Source: Postman Polaris-OpenAPI-Order / Signed-Order / order test (validate only).
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
price |
query | string | No | ||
quantity |
query | string | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
side |
query | string | No | ||
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
symbol |
query | string | No | ||
timeInForce |
query | string | No | ||
timestamp |
query | integer | No | Auto-filled by Pre-request Script | |
type |
query | string | No |
Responses
Sub-Account¶
GET /openapi/v1/sub-account/asset¶
asset
Description
Source: Postman Polaris-OpenAPI-Order / SubAccount/Read / asset.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
email |
query | string | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
POST /openapi/v1/sub-account/create¶
create
Description
Source: Postman Polaris-OpenAPI-Order / SubAccount/Write / create.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Request body
Responses
GET /openapi/v1/sub-account/list¶
list
Description
Source: Postman Polaris-OpenAPI-Order / SubAccount/Read / list.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
limit |
query | integer | No | ||
page |
query | integer | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
GET /openapi/v1/sub-account/transfer/sub-history¶
sub-history
Description
Source: Postman Polaris-OpenAPI-Order / SubAccount/Read / sub-history.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
limit |
query | integer | No | ||
page |
query | integer | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
POST /openapi/v1/sub-account/transfer/sub-to-master¶
sub-to-master
Description
Source: Postman Polaris-OpenAPI-Order / SubAccount/Write / sub-to-master.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Request body
Responses
POST /openapi/v1/sub-account/transfer/universal-transfer¶
universal-transfer
Description
Source: Postman Polaris-OpenAPI-Order / SubAccount/Write / universal-transfer.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Request body
Responses
GET /openapi/v1/sub-account/transfer/universal-transfer-history¶
universal-transfer-history
Description
Source: Postman Polaris-OpenAPI-Order / SubAccount/Read / universal-transfer-history.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
limit |
query | integer | No | ||
page |
query | integer | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
GET /openapi/v1/sub-account/wallet/deposit/address¶
deposit address
Description
Source: Postman Polaris-OpenAPI-Order / SubAccount/Read / deposit address.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
coin |
query | string | No | ||
email |
query | string | No | ||
network |
query | string | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
GET /openapi/v1/sub-account/wallet/deposit/history¶
deposit history
Description
Source: Postman Polaris-OpenAPI-Order / SubAccount/Read / deposit history.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
email |
query | string | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
User Data Stream¶
POST /openapi/v1/userDataStream¶
create listenKey
Description
validKeyOnly — API key header, no signature. Saves listenKey to environment.
Source: Postman Polaris-OpenAPI-Order / ListenKey / create listenKey.
Also in Postman folder OpenAPI-WS.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyOnly |
header | string | N/A | No | API Key only (validKeyOnly). No signature. listenKey lifecycle. |
Responses
PUT /openapi/v1/userDataStream¶
keepalive listenKey
Description
Extend listenKey TTL. Call ~every 30 minutes.
Source: Postman Polaris-OpenAPI-Order / ListenKey / keepalive listenKey.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyOnly |
header | string | N/A | No | API Key only (validKeyOnly). No signature. listenKey lifecycle. |
listenKey |
query | string | No |
Responses
DELETE /openapi/v1/userDataStream¶
close listenKey
Description
Invalidate listenKey.
Source: Postman Polaris-OpenAPI-Order / ListenKey / close listenKey.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyOnly |
header | string | N/A | No | API Key only (validKeyOnly). No signature. listenKey lifecycle. |
listenKey |
query | string | No |
Responses
Payment Request¶
POST /openapi/v3/payment-request/delete-payment-request¶
delete
Description
Source: Postman Polaris-OpenAPI-Order / PaymentRequest/Write / delete.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Request body
Responses
GET /openapi/v3/payment-request/get-payment-request¶
get/list
Description
Source: Postman Polaris-OpenAPI-Order / PaymentRequest/Read / get/list.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
limit |
query | integer | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
POST /openapi/v3/payment-request/payment-request-reminder¶
reminder
Description
Source: Postman Polaris-OpenAPI-Order / PaymentRequest/Write / reminder.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Request body
Responses
POST /openapi/v3/payment-request/payment-requests¶
create
Description
Source: Postman Polaris-OpenAPI-Order / PaymentRequest/Write / create.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Request body
Responses
Wallet¶
GET /openapi/wallet/v1/config/getall¶
config getall
Description
Source: Postman Polaris-OpenAPI-Order / Wallet / config getall.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
GET /openapi/wallet/v1/deposit/address¶
deposit address
Description
Source: Postman Polaris-OpenAPI-Order / Wallet / deposit address.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
coin |
query | string | No | ||
network |
query | string | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
GET /openapi/wallet/v1/deposit/history¶
deposit history
Description
Source: Postman Polaris-OpenAPI-Order / Wallet / deposit history.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
coin |
query | string | No | ||
limit |
query | integer | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
POST /openapi/wallet/v1/withdraw/apply¶
withdraw apply
Description
JSON body + HMAC (query timestamp + body)
Source: Postman Polaris-OpenAPI-Order / Wallet-Write / withdraw apply.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Request body
Responses
GET /openapi/wallet/v1/withdraw/history¶
withdraw history
Description
Source: Postman Polaris-OpenAPI-Order / Wallet / withdraw history.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
ApiKeyHmac |
header | string | N/A | No | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. |
coin |
query | string | No | ||
limit |
query | integer | No | ||
recvWindow |
query | integer | No | Auto-filled by Pre-request Script | |
signature |
query | string | No | HMAC-SHA256 hex digest of originStr. | |
timestamp |
query | integer | No | Auto-filled by Pre-request Script |
Responses
Schemas¶
ErrorBody¶
| Name | Type | Description |
|---|---|---|
code |
integer | |
msg |
string |
Security schemes¶
| Name | Type | Scheme | Description |
|---|---|---|---|
| ApiKeyHmac | apiKey | API Key + HMAC-SHA256 signature. originStr = queryString(excluding signature) + body. | |
| ApiKeyOnly | apiKey | API Key only (validKeyOnly). No signature. listenKey lifecycle. |
Tags¶
| Name | Description |
|---|---|
| Public | |
| Market Data | |
| Spot Trading | |
| User Data Stream | |
| Account | |
| Wallet | |
| Convert | |
| Fiat | |
| Fiat Migration | |
| Sub-Account | |
| Transfer | |
| Margin & Fund Collect | |
| Payment Request |