EyesOnAssets Public API

サイト上でユーザーが目にするのと同じデータに、APIキーによる有料B2Bアクセスで接続できます: リアルタイムスクリーナー(crypto・forex・株式の価格/変動率/出来高)と、 Analyticsモジュール(銘柄ごとの−100〜+100のテクニカル+ファンダメンタルスコア)。 サイトアカウントは不要 — 必要なのはキーだけです。

REST / JSON ベースURL: /api/v1/public 認証: X-API-Keyヘッダー

認証

すべてのリクエストには、あなたのキーを含む X-API-Key ヘッダーが必要です。キーはプラン/契約内容の 合意後に手動で発行されます — このAPIにセルフサービスの登録はありません (「アクセス方法」を参照)。

キーは厳重に管理してください。 クライアント側(ブラウザ/モバイル) のコードには絶対に埋め込まず、サーバー側でのみ使用してください。キーが漏洩した場合は ご連絡いただければ即座に無効化できます。

クイックスタート

# 現在のプラン、制限、当月の残りクォータを確認
curl -H "X-API-Key: eoa_live_YOUR_KEY" \
  https://your-domain/api/v1/public/usage
# crypto市場の全銘柄のAnalyticsスコア
curl -H "X-API-Key: eoa_live_YOUR_KEY" \
  https://your-domain/api/v1/public/analytics/crypto/list

料金

プラン料金対応市場レート制限月間クォータ
Starter $250/月 任意の1市場(crypto/forex/株式) 30 req/分 20,000
Business $500/月 全3市場(スクリーナー+Analyticsセット) 120 req/分 150,000
Enterprise 個別見積り 全3市場+優先サポート 600 req/分 無制限

現在のプラン、市場制限、契約期間は GET /usage でいつでも確認できます。

制限とクォータ

独立した2種類の制限があります:

種類カウント対象超過時の挙動
レート制限 1分あたりのリクエスト数(プランに依存) 429 Too Many Requests、時間をおいて再試行
月間クォータ 暦月あたりの総リクエスト数 429 月間クォータ超過 — プランをアップグレードするか翌月をお待ちください
いずれの制限もキー単位(複数キーをお持ちの場合はクライアント単位)で 適用され、IPアドレス単位ではありません — NAT配下の複数サーバーから安全にAPIを呼び出せます。

エンドポイント一覧

GET/api/v1/public/usage

現在のプラン、許可された市場、制限値、当月の使用リクエスト数を返します。月間クォータの消費は通常のリクエストと同じです。

{
  "org_name": "Acme Trading LLC",
  "tier": "business",
  "status": "active",
  "allowed_markets": ["crypto", "forex", "stocks"],
  "rate_limit": "120/minute",
  "monthly_quota": 150000,
  "used_this_month": 4213,
  "contract_expires_at": null
}

GET/api/v1/public/screener/{market_type}/{exchange}/{instrument}

リアルタイムのスクリーナーデータ:市場/取引所/種別の組み合わせに含まれる全銘柄の価格・変動率・出来高。

パラメータ種類説明
market_typepathcrypto / forex / stocks
exchangepathbybit、binance、okx、moex、nasdaqなど — 市場とデプロイ先リージョンに依存
instrumentpathspot、perpetual、futures、stock、majorなど
volume_min / volume_maxquery、任意出来高フィルター
change_min / change_maxquery、任意変動率フィルター
# 例
curl -H "X-API-Key: ..." \
  ".../api/v1/public/screener/crypto/bybit/spot?volume_min=1000000"

GET/api/v1/public/ohlcv/{market_type}/{exchange}/{symbol}/{timeframe}

特定銘柄のOHLCVローソク足データ。

パラメータ種類説明
symbolpath例: BTC_USDT または BTC/USDT
timeframepath1m、5m、15m、1h、4h、1dなど
limitquery、任意本数、デフォルト200、最大1000

GET/api/v1/public/analytics/{market}/list

市場内のスコア算出済み全銘柄のAnalyticsスコア:判定、総合スコア、価格、変動率、価格ミニチャート。

GET/api/v1/public/analytics/{market}/{symbol}

単一銘柄の完全なレポート:重みと説明付きの各ファクター(テクニカル+ファンダメンタル)、テクニカル/ファンダメンタル/総合スコア、テキストサマリー。

{
  "market": "crypto", "symbol": "BTC",
  "overall_score": 16, "verdict": "neutral",
  "factors": [
    { "name": "rsi", "value": "54.1", "sentiment": "neutral", "explanation": "RSI 54 — 通常範囲内" }
    // ...
  ]
}

GET/api/v1/public/analytics/top-setups

単一銘柄の詳細ではなく、現時点でファクターの偏りが最も大きい注目銘柄を返します — 1つの市場、またはお使いのプランで許可された全市場を対象に |overall_score| でソートします。

パラメータ種類説明
marketquery、任意crypto/forex/stocks — 省略時はプランで許可された全市場
verdictquery、任意growth/decline — 省略時は両方
limitquery、任意デフォルト10、最大100

GET/api/v1/public/analytics/{market}/stats

この市場における判定の過去実績:期間別(1/5/21/30日)の勝率と平均リターン、 95%ウィルソン信頼区間付き。win_rate: null は 数値を出すのに十分なデータがまだないことを意味し、0ではありません。

[
  { "verdict": "growth", "horizon_days": 21, "sample_size": 142,
    "is_significant": true, "win_rate": 0.61,
    "win_rate_ci_low": 0.54, "win_rate_ci_high": 0.68,
    "avg_return_pct": 3.2, "source": "backfill" }
]

GET/api/v1/public/analytics/{market}/{symbol}/history

単一銘柄のスコア/判定の過去スナップショット — お客様側での独自バックテストにご利用いただけます。

パラメータ種類説明
limitquery、任意デフォルト90、最大1000(新しい順)

Webhooks — ポーリングではなくプッシュ通知

/analytics/{market}/{symbol} を定期的にポーリングする 代わりに、判定が変化した(growth ↔ decline ↔ neutral)ときの通知を購読できます。

POST /api/v1/public/webhooks
{ "callback_url": "https://your-server/hook", "market": "crypto" }
// レスポンスに含まれる"secret"は一度だけ表示されるので必ず保存してください

GET /api/v1/public/webhooks       // 購読一覧
DELETE /api/v1/public/webhooks/{id} // 購読解除

各配信は、あなたの callback_url への POST リクエストで、 X-Webhook-Signature ヘッダー (あなたのsecretを使ったリクエストボディのHMAC-SHA256 — 偽の通知でないか検証にご利用ください) が付与されます。callback_urlhttps:// である必要があります。 配信が10回連続で失敗すると、購読は自動的に無効化されます。

{
  "event": "verdict_changed", "market": "crypto", "symbol": "BTC",
  "old_verdict": "neutral", "new_verdict": "growth",
  "overall_score": 24, "timestamp": "2026-07-26T04:00:00+00:00"
}

エラーコード

コード理由
400market_type が不正(crypto/forex/stocksのみ有効)
401キーが未指定・無効・失効済み
403クライアントが停止中/契約期限切れ、またはその市場がプランに含まれていない
404この銘柄のAnalyticsがまだ計算されていない
429レート制限または月間クォータの超過
502データプロバイダー(取引所/相場フィード)の一時的なエラー — 時間をおいて再試行
503データサービス未初期化(サーバー再起動直後)

対応市場と取引所

APIはcrypto・forex・株式に対応しています(債券は未対応で、現在のセットには含まれません)。 特定の exchangeinstrument の組み合わせで利用できる取引所は、サーバーのデプロイ先リージョンによって異なります。 どの取引所が利用可能か不明な場合は、キー発行時にお問い合わせいただくか、 全リージョンで利用可能な crypto/bybit/spot から始めてください。

アクセス方法

アクセスはプランの合意後に手動で発行されます — ご利用用途と想定リクエスト量を添えて ご連絡ください。最適なプランの選定とキーの発行をサポートいたします。 サイト上でのセルフサービス登録や即時キー発行はあえて用意していません — お客様(個別対応によるオンボーディング)と当社(データ利用の管理)の双方を守るためです。