驗證訂單

接口信息

接口: POST /api/v1/orders/validate

描述: 驗證訂單的有效性（不創建訂單）

鑑權: API Key憑據認證

請求參數

字段	類型	必填	說明
order	object	是	訂單信息
order.maker	string	是	訂單創建者地址
order.principal	string	是	接收者地址
order.is_buy	bool	是	是否是買入
order.ticker	string	是	股票代碼
order.exchange	int	是	交易所ID
order.asset	string	是	資產代幣地址
order.price	string	是	價格
order.quantity	string	是	數量
order.incentive	string	是	激勵金額
order.deadline	long	是	截止時間戳
order.nonce	long	是	防重放數字
signature	string	是	訂單簽名

響應參數

字段	類型	說明
valid	boolean	訂單是否有效
order_hash	string	訂單哈希值
errors	array	錯誤信息列表
maker_balance	string	Maker餘額
maker_allowance	string	Maker授權額度
nonce_valid	boolean	nonce是否有效
signature_valid	boolean	簽名是否有效
not_expired	boolean	是否未過期

請求示例

curl -X POST "/api/v1/orders/validate" \
     -H "X-API-Key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "order": {
         "maker": "0x1234567890123456789012345678901234567890",
         "principal": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
         "is_buy": true,
         "ticker": "AAPL",
         "exchange": 0,
         "asset": "0x0000000000000000000000000000000000000001",
         "price": "150250000000000000000",
         "quantity": "100",
         "incentive": "1000000000000000000",
         "deadline": 1735689600,
         "nonce": 1
       },
       "signature": "0x..."
     }'

響應示例

{
    "code": 0,
    "data": {
        "valid": true,
        "order_hash": "0x1234567890abcdef...",
        "errors": [],
        "maker_balance": "10000000000000000000000",
        "maker_allowance": "5000000000000000000000",
        "nonce_valid": true,
        "signature_valid": true,
        "not_expired": true
    }
}

注意事項

• 此接口僅驗證訂單，不會創建訂單
• 可用於在鎖定訂單前進行預檢查
• 驗證項包括：餘額、授權額度、nonce、簽名、過期時間等