Financial Context 透過 openapi.fcontext.com 暴露已認證的 /api/market-data/* 市場資料介面。
1. 建立憑證
前往 fcontext.com 登入 Financial Context,開啟帳戶設定,為外部存取建立 API key。
請妥善保管 API key。建議使用環境變數或平台的密鑰管理器。
2. 請求行情
curl "https://openapi.fcontext.com/api/market-data/quote?symbols=AAPL.US,MSFT.US" \
-H "x-api-key: YOUR_FCONTEXT_API_KEY"
回應內容會包含所請求標的的行情資料。當前 API 支援 .US 標的和 US 市場篩選條件。
3. 在程式碼中呼叫 API
const baseUrl = "https://openapi.fcontext.com";
const apiKey = process.env.FCONTEXT_API_KEY;
export async function getQuote(symbols) {
const params = new URLSearchParams({ symbols: symbols.join(",") });
const response = await fetch(`${baseUrl}/api/market-data/quote?${params}`, {
headers: { "x-api-key": apiKey },
});
if (!response.ok) {
throw new Error(`Financial Context request failed: ${response.status}`);
}
return response.json();
}
常用首批請求
# 即時行情
curl "https://openapi.fcontext.com/api/market-data/quote?symbols=AAPL.US" \
-H "x-api-key: YOUR_FCONTEXT_API_KEY"
# 公司概況
curl "https://openapi.fcontext.com/api/market-data/fundamental/company?symbol=AAPL.US" \
-H "x-api-key: YOUR_FCONTEXT_API_KEY"
# 新聞
curl "https://openapi.fcontext.com/api/market-data/content/news?symbol=AAPL.US" \
-H "x-api-key: YOUR_FCONTEXT_API_KEY"
# 選股器
curl "https://openapi.fcontext.com/api/market-data/screener/search?market=US&conditions=pettm:10:50&count=20" \
-H "x-api-key: YOUR_FCONTEXT_API_KEY"
方法支援
市場資料介面支援 GET。篩選、分頁和其他選項請透過查詢參數傳入。