​
API interface mapping

​
Public

Legacy APIV3 API
/v1/public/system_info/v3/public/systemInfo
/v1/public/info/v3/public/instruments
/v1/public/info/:symbol/v3/public/instruments
/v1/public/market_trades/v3/public/marketTrades
https://api-pub.woo.org/v1/hist/trade/v3/public/marketTradesHistory
/v1/public/orderbook/:symbol/v3/public/orderbook
/v1/public/kline/v3/public/kline
https://api-pub.woo.org/v1/hist/kline/v3/public/klineHistory
/v1/public/token/v3/public/token
/v1/public/token/v3/public/tokenInfo
/v1/public/token_network/v3/public/tokenNetwork
/v1/public/funding_rates/v3/public/fundingRate
/v1/public/funding_rate/:symbol/v3/public/fundingRate
/v1/public/funding_rate_history/v3/public/fundingRateHistory
/v1/public/futures/v3/public/futures
/v1/public/futures/:symbol/v3/public/futures

​
Trading

Legacy APIV3 API
POST /v1/orderPOST /v3/trade/order
DELETE /v1/orderDELETE /v3/trade/order
DELETE /v1/client/orderDELETE /v3/trade/order
DELETE /v1/ordersDELETE /v3/trade/orders
DELETE /v3/orders/pendingDELETE /v3/trade/orders
GET /v1/order/:oidGET /v3/trade/order
GET /v1/client/order/:client_order_idGET /v3/trade/order
GET /v1/ordersGET /v3/trade/orders
PUT /v3/order/:order_idPUT /v3/trade/order
PUT /v3/order/client/:client_order_idPUT /v3/trade/order
POST /v3/algo/orderPOST /v3/trade/algoOrder
DELETE /v3/algo/order/:order_idDELETE /v3/trade/algoOrder
DELETE /v3/algo/orders/pendingDELETE /v3/trade/algoOrders
DELETE /v3/merge/orders/pending/:symbolDELETE /v3/trade/allOrders
GET /v3/algo/order/:oidGET /v3/trade/algoOrder
GET /v3/algo/ordersGET /v3/trade/algoOrders
PUT /v3/algo/order/:order_idPUT /v3/trade/algoOrder
PUT /v3/algo/order/client/:client_order_idPUT /v3/trade/algoOrder
GET /v1/client/trade/:tidGET /v3/trade/transaction
GET /v1/order/:oid/tradesGET /v3/trade/transactionHistory
GET /v1/client/tradesGET /v3/trade/transactionHistory
GET /v1/client/hist_tradesGET /v3/trade/transactionHistory
POST /v1/order/cancel_all_afterPOST /v3/trade/cancelAllAfter

​
Account

Legacy APIV3 API
GET /v1/client/infoGET /v3/account/info
GET /v3/accountinfoGET /v3/account/info
GET /v1/client/tokenGET /v3/account/tokenConfig
GET /v1/client/tokenGET /v3/account/symbolConfig
POST /v1/client/account_modePOST /v3/account/tradingMode
GET /v3/referralsGET /v3/account/referral/summary
GET /v3/referral_rewardsGET /v3/account/referral/rewardHistory
GET /usercenter/api/enabled_credentialGET /v3/account/credentials
GET /v1/sub_account/allGET /v3/account/subAccounts/all

​
Assets

Legacy APIV3 API
GET /v1/client/holdingGET /v3/asset/balances
GET /v2/client/holdingGET /v3/asset/balances
GET /v3/balancesGET /v3/asset/balances
GET /v1/client/transaction_historyGET /v3/asset/token/history
POST /v1/asset/main_sub_transferPOST /v3/asset/transfer
GET /v1/asset/main_sub_transfer_historyGET /v3/asset/transfer/history
GET /v1/asset/depositGET /v3/asset/wallet/deposit
POST /v1/asset/withdrawPOST /v3/asset/wallet/withdraw
POST /v3/asset/withdrawPOST /v3/asset/wallet/withdraw
GET /v1/asset/historyGET /v3/asset/wallet/history

​
Futures

Legacy APIV3 API
GET /v1/positionsGET /v3/futures/positions
GET /v3/positionsGET /v3/futures/positions
GET /v1/position/:symbolGET /v3/futures/positions
POST /v1/client/position_modePUT /v3/futures/positionMode
GET /v1/client/futures_leverageGET /v3/futures/leverage
POST /v1/client/futures_leveragePUT /v3/futures/leverage
GET /v1/funding_fee/historyGET /v3/futures/fundingFee/history

​
Spot margin

Legacy APIV3 API
POST /v1/client/leveragePOST /v3/spotMargin/leverage
GET /v1/token_interestGET /v3/spotMargin/interestRate
GET /v1/token_interest/:tokenGET /v3/spotMargin/interestRate
GET /v1/interest/historyGET /v3/spotMargin/interestHistory
POST /v1/interest/repayPOST /v3/spotMargin/interestRepay
GET /v3/buypowerGET /v3/spotMargin/maxMargin

​
Code example

​
GET demo

​
V3

import requests
import datetime
import hmac, hashlib

def get_v3(base_url, request_path):
    api_key = '{put your api_key here}'
    api_secret = '{put your api_secret here}'
    timestamp = round(datetime.datetime.now().timestamp() * 1000)

    signString = str(timestamp) + 'GET' + request_path
    api_signature = hmac.new(bytes(api_secret, 'utf-8'), bytes(signString, 'utf-8'), hashlib.sha256).hexdigest()

    headers = {
        'x-api-key': api_key,
        'x-api-signature': api_signature,
        'x-api-timestamp': str(timestamp)
    }
    response = requests.get(base_url + request_path, headers=headers)
    result = response.json()
    print(result)
    return result

base_url = 'https://api.woox.io'
get_v3(base_url, '/v3/trade/order?orderId={orderId}')

​
Legacy V1

import requests
import datetime
import hmac, hashlib

def get_legacy_v1(base_url, request_path):
    api_key = '{put your api_key here}'
    api_secret = '{put your api_secret here}'
    timestamp = round(datetime.datetime.now().timestamp() * 1000)

    signString = str(timestamp) + 'GET' + request_path
    api_signature = hmac.new(bytes(api_secret, 'utf-8'), bytes(signString, 'utf-8'), hashlib.sha256).hexdigest()

    headers = {
        'x-api-key': api_key,
        'x-api-signature': api_signature,
        'x-api-timestamp': str(timestamp),
        'Content-Type': 'application/x-www-form-urlencoded;charset=utf-8'
    }
    response = requests.get(base_url + request_path, headers=headers)
    result = response.json()
    print(result)
    return result

base_url = 'https://api.woox.io'
get_legacy_v1(base_url, '/v1/order/{orderId}')

​
Legacy V3

import requests
import datetime
import hmac, hashlib

def get_legacy_v3(base_url, request_path):
    api_key = '{put your api_key here}'
    api_secret = '{put your api_secret here}'
    timestamp = round(datetime.datetime.now().timestamp() * 1000)

    signString = str(timestamp) + 'GET' + request_path
    api_signature = hmac.new(bytes(api_secret, 'utf-8'), bytes(signString, 'utf-8'), hashlib.sha256).hexdigest()

    headers = {
        'x-api-key': api_key,
        'x-api-signature': api_signature,
        'x-api-timestamp': str(timestamp),
        'Content-Type': 'application/x-www-form-urlencoded;charset=utf-8'
    }
    response = requests.get(base_url + request_path, headers=headers)
    result = response.json()
    print(result)
    return result

base_url = 'https://api.woox.io'
get_legacy_v3(base_url, '/v1/order/{orderId}')

​
POST demo

​
V3

import requests
import datetime
import hmac, hashlib

def post_v3(base_url, request_path, request_body):
    api_key = '{put your api_key here}'
    api_secret = '{put your api_secret here}'
    timestamp = round(datetime.datetime.now().timestamp() * 1000)

    signString = str(timestamp) + 'POST' + request_path + request_body
    api_signature = hmac.new(bytes(api_secret, 'utf-8'), bytes(signString, 'utf-8'), hashlib.sha256).hexdigest()

    headers = {
        'x-api-key': api_key,
        'x-api-signature': api_signature,
        'x-api-timestamp': str(timestamp),
        'Content-Type': 'application/json'
    }
    response = requests.post(base_url + request_path, headers=headers, data=request_body)
    result = response.json()
    print(result)
    return result

base_url = 'https://api.woox.io'
post_v3(base_url, '/v3/trade/order', '''{
    "symbol": "{symbol}",
    "side": "{side}",
    "type": "{type}",
    "price": "{price}",
    "quantity": "{quantity}"
}''')

​
Legacy V1

import requests
import datetime
import hmac, hashlib

def post_legacy_v1(base_url, request_path, request_body):
    api_key = '{put your api_key here}'
    api_secret = '{put your api_secret here}'
    timestamp = round(datetime.datetime.now().timestamp() * 1000)

    signString = str(timestamp) + 'POST' + request_path + request_body
    api_signature = hmac.new(bytes(api_secret, 'utf-8'), bytes(signString, 'utf-8'), hashlib.sha256).hexdigest()

    headers = {
        'x-api-key': api_key,
        'x-api-signature': api_signature,
        'x-api-timestamp': str(timestamp),
        'Content-Type': 'application/x-www-form-urlencoded;charset=utf-8'
    }
    response = requests.post(base_url + request_path, headers=headers, data=request_body)
    result = response.json()
    print(result)

base_url = 'https://api.woox.io'
post_legacy_v1(base_url, '/v1/order', 'order_price={order_price}&order_quantity={order_quantity}&order_type={order_type}&side={side}&symbol={symbol}')

​
Legacy V3

import requests
import datetime
import hmac, hashlib

def post_legacy_v3(base_url, request_path, request_body):
    api_key = '{put your api_key here}'
    api_secret = '{put your api_secret here}'
    timestamp = round(datetime.datetime.now().timestamp() * 1000)

    signString = str(timestamp) + 'POST' + request_path + request_body
    api_signature = hmac.new(bytes(api_secret, 'utf-8'), bytes(signString, 'utf-8'), hashlib.sha256).hexdigest()
    headers = {
        'x-api-timestamp': str(timestamp),
        'x-api-key': api_key,
        'x-api-signature': api_signature,
        'Content-Type': 'application/json'
    }
    response = requests.post(base_url + request_path, headers=headers, data=request_body)
    result = response.json()
    print(result)
    return result

base_url = 'https://api.woox.io'
post_legacy_v3(base_url, '/v3/algo/order','''{
    "symbol": {symbol},
    "side": {side},
    "algoType": {algoType},
    "triggerPrice": {triggerPrice},
    "type": {type},
    "quantity": {quantity},
    "price": {price}
}''')

​
PUT demo

​
V3

import requests
import datetime
import hmac, hashlib

def put_v3(base_url, request_path, request_body):
    api_key = '{put your api_key here}'
    api_secret = '{put your api_secret here}'
    timestamp = round(datetime.datetime.now().timestamp() * 1000)

    signString = str(timestamp) + 'PUT' + request_path + request_body
    api_signature = hmac.new(bytes(api_secret, 'utf-8'), bytes(signString, 'utf-8'), hashlib.sha256).hexdigest()

    headers = {
        'x-api-key': api_key,
        'x-api-signature': api_signature,
        'x-api-timestamp': str(timestamp),
        'Content-Type': 'application/json'
    }
    response = requests.put(base_url + request_path, headers=headers, data=request_body)
    result = response.json()
    print(result)
    return result

base_url = 'https://api.woox.io'
put_v3(base_url, '/v3/trade/order', '''{
    "orderId": "{orderId}",
    "price": "{price}",
    "quantity": "{quantity}"
}''')

​
Legacy V3

import requests
import datetime
import hmac, hashlib

def put_legacy_v3(base_url, request_path, request_body):
    api_key = '{put your api_key here}'
    api_secret = '{put your api_secret here}'
    timestamp = round(datetime.datetime.now().timestamp() * 1000)

    signString = str(timestamp) + 'PUT' + request_path + request_body
    api_signature = hmac.new(bytes(api_secret, 'utf-8'), bytes(signString, 'utf-8'), hashlib.sha256).hexdigest()
    headers = {
        'x-api-timestamp': str(timestamp),
        'x-api-key': api_key,
        'x-api-signature': api_signature,
        'Content-Type': 'application/json'
    }
    response = requests.put(base_url + request_path, headers=headers, data=request_body)
    result = response.json()
    print(result)
    return result

base_url = 'https://api.woox.io'
put_legacy_v3(base_url, '/v3/algo/order/{orderId}','''{
    "price": {price}
}''')

​
DELETE demo

​
V3

import requests
import datetime
import hmac, hashlib

def delete_v3(base_url, request_path):
    api_key = '{put your api_key here}'
    api_secret = '{put your api_secret here}'
    timestamp = round(datetime.datetime.now().timestamp() * 1000)

    signString = str(timestamp) + 'DELETE' + request_path
    api_signature = hmac.new(bytes(api_secret, 'utf-8'), bytes(signString, 'utf-8'), hashlib.sha256).hexdigest()

    headers = {
        'x-api-key': api_key,
        'x-api-signature': api_signature,
        'x-api-timestamp': str(timestamp)
    }
    response = requests.delete(base_url + request_path, headers=headers)
    result = response.json()
    print(result)
    return result

base_url = 'https://api.woox.io'
delete_v3(base_url, '/v3/trade/order?symbol={symbol}&orderId={orderId}')

​
Legacy V1

import requests
import datetime
import hmac, hashlib

def delete_legacy_v1(base_url, request_path, request_parameter):
    api_key = '{put your api_key here}'
    api_secret = '{put your api_secret here}'
    timestamp = round(datetime.datetime.now().timestamp() * 1000)

    signString = str(timestamp) + 'DELETE' + request_path + request_parameter
    api_signature = hmac.new(bytes(api_secret, 'utf-8'), bytes(signString, 'utf-8'), hashlib.sha256).hexdigest()

    headers = {
        'x-api-key': api_key,
        'x-api-signature': api_signature,
        'x-api-timestamp': str(timestamp),
        'Content-Type': 'application/x-www-form-urlencoded;charset=utf-8'
    }
    response = requests.delete(base_url + request_path, headers=headers, data=request_parameter)
    result = response.json()
    print(result)
    return result

base_url = 'https://api.woox.io'
delete_legacy_v1(base_url, '/v1/order', 'order_id={orderId}&symbol={symbol}')

​
Legacy V3

import requests
import datetime
import hmac, hashlib

def delete_legacy_v3(base_url, request_path):
    api_key = '{put your api_key here}'
    api_secret = '{put your api_secret here}'
    timestamp = round(datetime.datetime.now().timestamp() * 1000)

    signString = str(timestamp) + 'DELETE' + request_path
    api_signature = hmac.new(bytes(api_secret, 'utf-8'), bytes(signString, 'utf-8'), hashlib.sha256).hexdigest()

    headers = {
        'x-api-key': api_key,
        'x-api-signature': api_signature,
        'x-api-timestamp': str(timestamp),
        'Content-Type': 'application/x-www-form-urlencoded;charset=utf-8'
    }
    response = requests.delete(base_url + request_path, headers=headers)
    result = response.json()
    print(result)
    return result

base_url = 'https://api.woox.io'
delete_legacy_v3(base_url, '/v3/algo/order/{orderId}')