獲取股票Token地址

接口信息

接口: GET /api/v1/instruments/token-address

描述: 根據股票代碼和交易所ID獲取對應的Token合約地址

鑑權: Authorization請求頭附加JWT令牌

請求參數

參數	類型	必填	說明
ticker	string	是	股票代碼（如AAPL）
exchange	number	是	交易所ID，詳見 Exchange 枚舉

響應參數

字段	類型	說明
ticker	string	股票代碼
name	string	股票名稱
exchange_id	number	交易所ID
token_address	string	Token合約地址

請求示例

curl -X GET "/api/v1/instruments/token-address?ticker=AAPL&exchange=0" \
     -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
     -H "Content-Type: application/json"

響應示例

成功響應

{
  "code": 0,
  "data": {
    "ticker": "AAPL",
    "name": "Apple Inc.",
    "exchange_id": 0,
    "token_address": "0x1234567890abcdef..."
  }
}

錯誤響應

缺少ticker參數:

{
  "error": "ticker parameter is required"
}

缺少exchange參數:

{
  "error": "exchange parameter is required"
}

股票不存在:

{
  "error": "Instrument not found"
}

使用場景

• 創建訂單前查詢股票對應的Token地址
• 驗證股票是否已在平台上線
• 獲取股票的基本信息