FINGER TRADER

marketDataDocsPage.restInstruments

支援 Ticker/Symbol

使用分頁 ticker-list 端點,查詢券商/交易商為此帳戶設定的 Ticker 與 Symbol。請選用「支援市場列表」API 回傳的 marketType。

文檔架構 · 概覽

POST /app-api/v1/market/ticker-list

此端點以分頁方式回傳清單。設定 page(Flutter 用戶端從 1 開始)及 pageSize;query.marketType 用來篩選市場,query.brokerId 為選填。回應包含該頁的 data.total 與 data.items。最大分頁筆數及商品涵蓋範圍由券商/交易商或服務設定決定。

POST /app-api/v1/market/ticker-list
{ "page": 1, "pageSize": 20, "query": { "marketType": <marketType from overview>, "brokerId": null } }
請求欄位
ticker-list:page、pageSize、query.marketType、query.brokerId

回應格式範例

App 會解析標準 API 外層格式,以及包含 total 和 items 的分頁資料。範例列出用戶端已知欄位;可空欄位或額外欄位可能不會出現。

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      { "ticker": "<TICKER>", "symbol": "<SYMBOL>", "name": "<DISPLAY_NAME>" }
    ]
  }
}

每個市場實際設定及提供哪些 Ticker/Symbol 由你的券商/交易商決定。Finger Trader 無法保證券商/交易商支援某一市場下的所有 Ticker/Symbol。請向券商/交易商確認商品涵蓋範圍及可用性。

試用 REST 請求

輸入 Access Token 並編輯請求參數。送出後,瀏覽器會直接向所選的 Finger Trader 官方 BFF 環境發送此請求。

POST /app-api/v1/market/ticker-list

準備就緒。按下「送出請求」前不會傳送內容。

回應
回應會顯示在這裡。

Access Token 只保留在此頁面的記憶體中,不會寫入瀏覽器儲存空間,也不會傳送至 Finger Trader 官網伺服器。只有按下「送出請求」後,才會傳至你選擇的官方 API 環境;完成後請清除。

若瀏覽器顯示 CORS 或網路錯誤,可能是 API 環境未允許此網站來源。請使用已核準的伺服器端用戶端或 API 工具;不要關閉瀏覽器安全防護。

POST /app-api/v1/market/ticker-detail

使用 ticker、market 和 brokerId 查詢商品詳情。服務有回傳時,用戶端資料模型會解析報價與商品交易參數。

POST /app-api/v1/market/ticker-detail
{ "ticker": "<broker-configured ticker>", "market": <marketType from overview>, "brokerId": null }

試用 REST 請求

輸入 Access Token 並編輯請求參數。送出後,瀏覽器會直接向所選的 Finger Trader 官方 BFF 環境發送此請求。

POST /app-api/v1/market/ticker-detail

準備就緒。按下「送出請求」前不會傳送內容。

回應
回應會顯示在這裡。

Access Token 只保留在此頁面的記憶體中,不會寫入瀏覽器儲存空間,也不會傳送至 Finger Trader 官網伺服器。只有按下「送出請求」後,才會傳至你選擇的官方 API 環境;完成後請清除。

若瀏覽器顯示 CORS 或網路錯誤,可能是 API 環境未允許此網站來源。請使用已核準的伺服器端用戶端或 API 工具;不要關閉瀏覽器安全防護。

POST /app-api/v1/market/search-ticker

使用 keyword、page 和 pageSize 搜尋商品;用戶端會將回應解析為 ticker 項目列表。

POST /app-api/v1/market/search-ticker
{ "keyword": "EURUSD", "page": 1, "pageSize": 20 }

試用 REST 請求

輸入 Access Token 並編輯請求參數。送出後,瀏覽器會直接向所選的 Finger Trader 官方 BFF 環境發送此請求。

POST /app-api/v1/market/search-ticker

準備就緒。按下「送出請求」前不會傳送內容。

回應
回應會顯示在這裡。

Access Token 只保留在此頁面的記憶體中,不會寫入瀏覽器儲存空間,也不會傳送至 Finger Trader 官網伺服器。只有按下「送出請求」後,才會傳至你選擇的官方 API 環境;完成後請清除。

若瀏覽器顯示 CORS 或網路錯誤,可能是 API 環境未允許此網站來源。請使用已核準的伺服器端用戶端或 API 工具;不要關閉瀏覽器安全防護。

以下是 Flutter 用戶端定義的 marketType 列舉值,並非你的券商/交易商已開通市場清單。實際支援範圍由券商/交易商的帳戶及連線設定決定,請向券商/交易商索取支援市場清單。REST 市場篩選及歷史行情請求使用相應代碼;WebSocket 訂閱則先從該市場的券商/交易商商品清單取得 ticker,再訂閱該 ticker。你可用 ticker-list 檢視回傳商品,但空結果本身不足以判定市場不受支援。