DN-01SOON
Market Data API
第二期での公開に先立ち、REST / JSON、認証、データセットの予定仕様を技術プレビューとして掲載しています。
- Endpoint
api.arcaneflux.com/v1/market-data- Protocol
- REST / JSON
- Metering
- Request based
01 / QUICKSTART
最初の価格データを取得
Bearer API key を設定し、Quotes エンドポイントから JSON レスポンスを確認します。始める前に
- Market Data API を利用できるアカウント
- Market Data API を許可した API キー
- curl と JSON を確認できる環境
1. API キーを設定
export ARCANEFLUX_API_KEY="your_api_key"
export ARCANEFLUX_BASE_URL="https://api.arcaneflux.com/v1/market-data"2. Bearer authentication
すべてのリクエストで Authorization ヘッダーへ API key を設定します。
Authorization: Bearer $ARCANEFLUX_API_KEY3. Quotes を取得
curl "$ARCANEFLUX_BASE_URL/quotes" \
--get \
--data-urlencode "symbols=BTC-USD" \
-H "Authorization: Bearer $ARCANEFLUX_API_KEY"4. レスポンスを確認
- HTTP ステータスと Content-Type
- 銘柄識別子、値、タイムスタンプ
- レスポンスの request ID
- コンソールに記録された呼び出し数
02 / DATASETS
Datasets
Quotes、Markets、History の用途と更新の前提を確認します。| Dataset | Purpose | Update |
|---|---|---|
| Quotes | 銘柄ごとの最新値と時刻 | 公開データセット仕様に従う |
| Markets | 利用可能な市場と銘柄 | 定期更新 |
| History | 指定期間の時系列データ | 対象範囲に従う |
03 / OPERATIONS
Usage & quota
呼び出し数は API キーと期間から確認します。レスポンスの request ID と時間帯を記録すると、利用量とエラーを同じ条件で照合できます。
Limits
Rate limit と月間呼び出し数はプランと API キーの Quota によって異なります。
| HTTP | code | Action |
|---|---|---|
| 429 | rate_limit_exceeded | Retry-After 後に再試行 |
| 429 | insufficient_quota | 残高またはプランを確認 |
04 / API REFERENCE
API Reference
代表的なパス、必須パラメータ、Bearer 認証とエラーを確認します。Base URL
https://api.arcaneflux.com/v1/market-dataEndpoints
| Method | Path | Purpose |
|---|---|---|
| GET | /quotes | 指定した銘柄の最新値を取得 |
| GET | /markets | 市場と利用可能な銘柄を取得 |
| GET | /history | 期間を指定して時系列を取得 |
ページネーション、日時形式、銘柄識別子、必須パラメータは公開時の API 定義を確認してください。
Errors
| HTTP | code | Client action |
|---|---|---|
| 401 | invalid_api_key | Bearer key を確認 |
| 403 | subscription_required | Market Data API を開通 |
| 404 | unknown_product | Base URL とパスを確認 |
| 502 | upstream_error | request ID を保存して再試行 |
| 504 | upstream_timeout | timeout と再試行上限を確認 |
05 / SUPPORT
Frequently asked questions
データが取得できない場合は認証、対象銘柄、時間範囲を順に確認します。銘柄が見つからない
Markets で利用可能な識別子と対象市場を確認します。
値の時刻が想定と違う
タイムゾーン、更新頻度、対象データセットの仕様を確認します。
06 / RELEASE NOTES