メインコンテンツへスキップ
Financial Context は外部の市場データ呼び出しに対して、2 種類の認証情報を受け付けます。
  • Financial Context のアカウント設定で作成した API key
  • 承認済みの CLI、MCP、agent クライアント向け OAuth bearer token
API リクエストにはこれらの Financial Context 認証情報を使用します。

​
API Key Header

curl "https://openapi.fcontext.com/api/market-data/quote?symbols=AAPL.US" \
  -H "x-api-key: YOUR_FCONTEXT_API_KEY"
x-api-key はサーバー間連携で推奨される header です。

​
OAuth Bearer Token

curl "https://openapi.fcontext.com/api/market-data/quote?symbols=AAPL.US" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
Bearer token には market_data scope の市場データアクセス権が必要です。

​
JavaScript の例

const response = await fetch("https://openapi.fcontext.com/api/market-data/quote?symbols=AAPL.US", {
  headers: {
    "x-api-key": process.env.FCONTEXT_API_KEY,
  },
});

if (!response.ok) {
  throw new Error(`Request failed with ${response.status}`);
}

const data = await response.json();

​
Python の例

import os
import requests

response = requests.get(
    "https://openapi.fcontext.com/api/market-data/quote",
    params={"symbols": "AAPL.US"},
    headers={"x-api-key": os.environ["FCONTEXT_API_KEY"]},
    timeout=30,
)
response.raise_for_status()
data = response.json()

​
エラーレスポンス

ステータス意味
401認証情報がない、期限切れ、または無効
402有料プランまたは残りのデータリクエスト枠が必要
403認証情報は有効だが、市場データアクセス権がない
キーは定期的にローテーションし、使用しなくなったキーは取り消してください。