📈Spot
Public
Test Connectivity
Endpoint:
GET https://openapi.fokawa.com/sapi/v1/ping
Description:
This endpoint checks connectivity to the host.
Response:
200: OK
- Connection normal
Check Server Time
Endpoint:
GET https://openapi.fokawa.com/sapi/v1/time
Description:
This endpoint checks connectivity to the server and retrieves server timestamp.
Response:
200: OK
- Successfully retrieved server time
{
"timezone": "GMT+08:00",
"serverTime": 1595563624731
}
Pairs List
Endpoint:
GET https://openapi.fokawa.com/sapi/v1/symbols
Description:
Retrieve a list of trading pairs.
Response:
200: OK
{
"symbols": [
{
"quantityPrecision": 3,
"symbol": "sccadai",
"pricePrecision": 6,
"baseAsset": "SCCA",
"quoteAsset": "DAI"
},
{
"quantityPrecision": 8,
"symbol": "btcusdt",
"pricePrecision": 2,
"baseAsset": "BTC",
"quoteAsset": "USDT"
},
{
"quantityPrecision": 3,
"symbol": "bchusdt",
"pricePrecision": 2,
"baseAsset": "BCH",
"quoteAsset": "USDT"
},
{
"quantityPrecision": 2,
"symbol": "etcusdt",
"pricePrecision": 2,
"baseAsset": "ETC",
"quoteAsset": "USDT"
},
{
"quantityPrecision": 2,
"symbol": "ltcbtc",
"pricePrecision": 6,
"baseAsset": "LTC",
"quoteAsset": "BTC"
}
]
}
Response Fields
symbol: string - Name of the symbol (e.g., BTCUSDT)
baseAsset: string - Underlying asset for the symbol (e.g., BTC)
quoteAsset: string - Quote asset for the symbol (e.g., USDT)
pricePrecision: integer - Precision of the price
quantityPrecision: integer - Precision of the quantity
Market
Depth
Endpoint:
GET https://openapi.fokawa.com/sapi/v1/depth
Description:
Retrieve market depth data.
Query Parameters:
symbol: string (required) - Symbol Name (e.g., BTCUSDT)
limit: integer (default 100; max 100)
Response:
200: OK
- Successfully retrieved market depth data
{
"bids": [
[
"3.90000000", // price
"431.00000000" // volume
],
[
"4.00000000",
"431.00000000"
]
],
"asks": [
[
"4.00000200", // price
"12.00000000" // volume
],
[
"5.10000000",
"28.00000000"
]
]
}
Response Fields
time: long - Current timestamp (ms)
bids: list - List of all bids, best bids first
asks: list - List of all asks, best asks first
24hrs Ticker
Endpoint:
GET https://openapi.fokawa.com/sapi/v1/ticker
Description:
Retrieve 24-hour price change statistics.
Query Parameters:
symbol: string (required) - Symbol Name (e.g., BTCUSDT)
Response:
200: OK
- Successfully retrieved ticker data
{
"high": "9279.0301",
"vol": "1302",
"last": "9200",
"low": "9279.0301",
"rose": "0",
"time": 1595563624731
}
Response Fields
time: long - Open Time
high: float - High Price
low: float - Low Price
open: float - Open Price
last: float - Last Price
vol: float - Trade Volume
rose: float - Price increase or Price rise
Recent Trades List
Endpoint:
GET https://openapi.fokawa.com/sapi/v1/trades
Query Parameters:
symbol: string (required) - Symbol Name (e.g., BTCUSDT)
limit: string (default 100; max 1000)
Response:
200: OK
{
"list": [
{
"price": "3.00000100",
"qty": "11.00000000",
"time": 1499865549590,
"side": "BUY"
}
]
}
Response Fields
price: float - The price of the trade
time: long - Current timestamp (ms)
qty: float - The quantity traded
side: string - BUY/SELL (Taker side)
Kline/Candlestick Data
Endpoint:
GET https://openapi.fokawa.com/sapi/v1/klines
Query Parameters:
symbol: string (required) - Symbol Name (e.g., BTCUSDT)
interval: string (required) - Interval of the Kline. Possible values include: 1min, 5min, 15min, 30min, 60min, 1day, 1week, 1month
startTime: long - Start time (e.g., 1538728740000)
endTime: long - End time (e.g., 1538728740000)
limit: string (default 100; max 300)
Response:
200: OK
[
{
"high": "6228.77",
"vol": "111",
"low": "6228.77",
"idx": 1594640340,
"close": "6228.77",
"open": "6228.77"
},
{
"high": "6228.77",
"vol": "222",
"low": "6228.77",
"idx": 1587632160,
"close": "6228.77",
"open": "6228.77"
},
{
"high": "6228.77",
"vol": "333",
"low": "6228.77",
"idx": 1587632100,
"close": "6228.77",
"open": "6228.77"
}
]
Response Fields
idx: long - Open time
open: float - Open price
close: float - Close price
high: float - High price
low: float - Low price
vol: float - Volume
Trade
New Order
Endpoint:
POST https://openapi.fokawa.com/sapi/v1/order
Rate Limit:
100 times/2s
Headers:
X-CH-SIGN: string - Sign
X-CH-APIKEY: string - Your API-key
X-CH-TS: integer - Timestamp
Request Body:
symbol: string (required) - Symbol Name (e.g., BTCUSDT)
volume: number (required) - Order volume. For MARKET BUY orders, volume = amount.
side: string (required) - Side of the order, BUY/SELL
type: string (required) - Type of the order, LIMIT/MARKET
price: number - Order price, REQUIRED for LIMIT orders
newClientOrderId: string - Unique order ID generated by users to mark their orders
recvwindow: integer - Time window
Response:
200: OK
- Successfully posted new order
{
"symbol": "LXTUSDT",
"orderId": 150695552109032492,
"orderIdString": "150695552109032492", // Character String Type Order ID (Recommended)
"clientOrderId": "157371322565051",
"transactTime": "1573713225668",
"price": "0.005452",
"origQty": "110",
"executedQty": "0",
"status": "NEW",
"type": "LIMIT",
"side": "SELL"
}
Response Fields
orderId: long - ID of the order
clientorderId: string - Unique ID of the order
symbol: string - Symbol Name (e.g., BTCUSDT)
transactTime:
integer - Time the order is placed
price: float - Order price
origQty: float - Quantity ordered
executedQty: float - Quantity of orders that have been executed
type: string - Order type (LIMIT, MARKET)
side: string - Order side (BUY, SELL)
status: string - Order status (NEW, PARTIALLY_FILLED, FILLED, CANCELED, REJECTED)
Test New Order
Endpoint:
POST https://openapi.fokawa.com/sapi/v1/order/test
Description:
Test new order creation and signature/recvWindow length. Creates and validates a new order but does not send the order into the matching engine.
Headers:
X-CH-APIKEY: string - Your API-key
X-CH-TS: string - Timestamp
X-CH-SIGN: string - Sign
Request Body:
symbol: string (required) - Symbol Name (e.g., BTCUSDT)
volume: number (required) - Order volume. For MARKET BUY orders, volume = amount.
side: string (required) - Side of the order, BUY/SELL
type: string (required) - Type of the order, LIMIT/MARKET
price: number - Order price, REQUIRED for LIMIT orders
recvwindow: integer - Time window
newClientOrderId: string - Unique order ID generated by users to mark their orders
Response:
200: OK
- Successfully tested new order
{
// Response
}
Batch Orders
Endpoint:
POST https://openapi.fokawa.com/sapi/v1/batchOrders
Description:
Batch contains at most 10 orders.
Headers:
X-CH-APIKEY: string - Your API-key
X-CH-TS: string - Timestamp
X-CH-SIGN: string - Sign
Request Body:
orders: number - The batch order information can contain a maximum of 10 records
symbol: string (required) - Symbol Name (e.g., BTCUSDT)
Response:
200: OK
{
"idsString": [
"165964665990709251",
"165964665990709252",
"165964665990709253"
],
"ids": [
165964665990709251,
165964665990709252,
165964665990709253
]
}
Request Fields
price: float - Price
volume: float - Quantity
side: string - BUY/SELL (Direction)
batchType: string - LIMIT/MARKET (Type)
idsString: string - Collection of order numbers of type String
ids: integer - Collection of order numbers
Query Order
Endpoint:
GET https://openapi.fokawa.com/sapi/v1/order
Query Parameters:
orderId: string (required) - Order ID
newClientOrderId: string - Client Order Id, Unique order ID generated by users to mark their orders (e.g., 354444heihieddada)
symbol: string (required) - Symbol Name (e.g., BTCUSDT)
Headers:
X-CH-APIKEY: string - Your API-key
X-CH-TS: string - Timestamp
X-CH-SIGN: string - Sign
Response:
200: OK
{
"orderId": "499890200602846976",
"clientOrderId": "157432755564968",
"symbol": "BHTUSDT",
"price": "0.01",
"origQty": "50",
"executedQty": "0",
"avgPrice": "0",
"status": "NEW",
"type": "LIMIT",
"side": "BUY",
"transactTime": "1574327555669"
}
Response Fields
orderId: long - Order ID (system generated)
clientOrderId: string - Order ID (sent by yourself)
symbol: string - Currency Pair Name
price: float - Order Price
origQty: float - Number of orders
executedQty: float - Number of orders already filled
avgPrice: float - Average price of filled orders
type: string - Order type (LIMIT, MARKET)
side: string - Order direction (BUY, SELL)
status: string - Order status (NEW, PARTIALLY_FILLED, FILLED, CANCELED, REJECTED)
transactTime: string - Order Creation Time
Cancel Order
Endpoint:
POST https://openapi.fokawa.com/sapi/v1/cancel
Headers:
X-CH-APIKEY: string - Your API-key
X-CH-TS: string - Timestamp
X-CH-SIGN: string - Sign
Request Body:
newClientOrderId: string - Client Order Id, Unique order ID generated by users to mark their orders (e.g., 354444heihieddada)
orderId: string (required) - Order ID
symbol: string (required) - Symbol Name (e.g., BTCUSDT)
Response:
200: OK
{
"symbol": "BHTUSDT",
"clientOrderId": "0",
"orderId": "499890200602846976",
"status": "CANCELED"
}
Response Fields
orderId: long - ID of the order
clientOrderId: string - Unique ID of the order
symbol: string - Name of the symbol
status: string - The state of the order (NEW, PARTIALLY_FILLED, FILLED, CANCELED, REJECTED)
Batch Cancel Orders
Endpoint:
POST https://openapi.fokawa.com/sapi/v1/batchCancel
Description:
Batch contains at most 10 orders.
Headers:
X-CH-APIKEY: string - Your API-key
X-CH-TS: string - Timestamp
X-CH-SIGN: string - Sign
Request Body:
orderIds: string - Order ID collection [123,456]
symbol: string (required) - Symbol Name (e.g., BTCUSDT)
Response:
200: OK
{
"success": [
165964665990709251,
165964665990709252,
165964665990709253
],
"failed": [
165964665990709250
]
}
Current Open Orders
Endpoint:
GET https://openapi.fokawa.com/sapi/v1/openOrders
Query Parameters:
symbol: string (required) - Symbol Name (e.g., BTCUSDT)
limit: string (default 100; max 1000)
Headers:
X-CH-APIKEY: string - Your API-key
X-CH-TS: string - Timestamp
X-CH-SIGN: string - Sign
Response:
200: OK
[
{
"orderId": 499902955766523648,
"orderIdString": "499902955766523648", // Character String Type Order ID (Recommended)
"symbol": "BHTUSDT",
"price": "0.01",
"origQty": "50",
"executedQty": "0",
"avgPrice": "0",
"status": "NEW",
"type": "LIMIT",
"side": "BUY",
"time": "1574329076202"
}
]
Response Fields
orderId: long - ID of the order
orderIdString: string - Character String Type Order ID (Recommended)
clientOrderId: string - Unique ID of the order
symbol: string - Name of the symbol
price: float - Price of the order
origQty: float - Quantity ordered
executedQty: float - Quantity of orders that have been executed
avgPrice: float - Average price of filled orders
type: string - Order type (LIMIT, MARKET)
side: string - Order side (BUY, SELL)
status: string - Order status (NEW, PARTIALLY_FILLED, FILLED, CANCELED, REJECTED)
time: string - Creation Time
Trades
Endpoint:
GET https://openapi.fokawa.com/sapi/v1/myTrades
Query Parameters:
symbol: string (required) - Symbol Name (e.g., BTC
USDT)
limit: string (default 100; max 1000)
fromId: string - Trade Id to fetch from
Headers:
X-CH-APIKEY: string - Your API-key
X-CH-TS: string - Timestamp
X-CH-SIGN: string - Sign
Response:
200: OK
[
{
"symbol": "ETHBTC",
"id": 100211,
"bidId": 150695552109032492,
"askId": 150695552109032493,
"price": "4.00000100",
"qty": "12.00000000",
"time": 1499865549590,
"isBuyer": true,
"isMaker": false,
"feeCoin": "ETH",
"fee": "0.001",
"bidUserId": 23334,
"askUserId": 44112
}
]
Response Fields
symbol: string - Name of the symbol (e.g., BTCUSDT)
id: integer - Trade ID
bidId: long - Bid Order ID
askId: long - Ask Order ID
price: float - Price of the trade
qty: float - Quantity of the trade
time: long - Timestamp of the trade
isBuyer: bool - true = Buyer, false = Seller
isMaker: bool - true = Maker, false = Taker
feeCoin: string - Trading fee coin
fee: float - Trading fee
bidUserId: long - Buyer UID
askUserId: long - Seller UID
isSelf: bool - true = Self-dealt
Account
Account Information
Endpoint:
GET https://openapi.fokawa.com/sapi/v1/account
Headers:
X-CH-APIKEY: string - Your API-key
X-CH-TS: string - Timestamp
X-CH-SIGN: string - Sign
Response:
200: OK
- Successfully retrieved account information
{
"balances": [
{
"asset": "BTC",
"free": "0",
"locked": "0"
},
{
"asset": "ETH",
"free": "0",
"locked": "0"
}
]
}
Response Fields
balances: list - Show balance details
asset: string - Name of the asset (e.g., USDT)
free: float - Amount available for use
locked: float - Amount locked (for open orders)
Last updated