EyesOnAssets Public API
サイト上でユーザーが目にするのと同じデータに、APIキーによる有料B2Bアクセスで接続できます: リアルタイムスクリーナー(crypto・forex・株式の価格/変動率/出来高)と、 Analyticsモジュール(銘柄ごとの−100〜+100のテクニカル+ファンダメンタルスコア)。 サイトアカウントは不要 — 必要なのはキーだけです。
/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 月間クォータ超過 — プランをアップグレードするか翌月をお待ちください |
エンドポイント一覧
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_type | path | crypto / forex / stocks |
| exchange | path | bybit、binance、okx、moex、nasdaqなど — 市場とデプロイ先リージョンに依存 |
| instrument | path | spot、perpetual、futures、stock、majorなど |
| volume_min / volume_max | query、任意 | 出来高フィルター |
| change_min / change_max | query、任意 | 変動率フィルター |
# 例 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ローソク足データ。
| パラメータ | 種類 | 説明 |
|---|---|---|
| symbol | path | 例: BTC_USDT または BTC/USDT |
| timeframe | path | 1m、5m、15m、1h、4h、1dなど |
| limit | query、任意 | 本数、デフォルト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| でソートします。
| パラメータ | 種類 | 説明 |
|---|---|---|
| market | query、任意 | crypto/forex/stocks — 省略時はプランで許可された全市場 |
| verdict | query、任意 | growth/decline — 省略時は両方 |
| limit | query、任意 | デフォルト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
単一銘柄のスコア/判定の過去スナップショット — お客様側での独自バックテストにご利用いただけます。
| パラメータ | 種類 | 説明 |
|---|---|---|
| limit | query、任意 | デフォルト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_url は
https:// である必要があります。
配信が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"
}
エラーコード
| コード | 理由 |
|---|---|
| 400 | market_type が不正(crypto/forex/stocksのみ有効) |
| 401 | キーが未指定・無効・失効済み |
| 403 | クライアントが停止中/契約期限切れ、またはその市場がプランに含まれていない |
| 404 | この銘柄のAnalyticsがまだ計算されていない |
| 429 | レート制限または月間クォータの超過 |
| 502 | データプロバイダー(取引所/相場フィード)の一時的なエラー — 時間をおいて再試行 |
| 503 | データサービス未初期化(サーバー再起動直後) |
対応市場と取引所
APIはcrypto・forex・株式に対応しています(債券は未対応で、現在のセットには含まれません)。
特定の exchange/instrument
の組み合わせで利用できる取引所は、サーバーのデプロイ先リージョンによって異なります。
どの取引所が利用可能か不明な場合は、キー発行時にお問い合わせいただくか、
全リージョンで利用可能な crypto/bybit/spot から始めてください。
アクセス方法
アクセスはプランの合意後に手動で発行されます — ご利用用途と想定リクエスト量を添えて ご連絡ください。最適なプランの選定とキーの発行をサポートいたします。 サイト上でのセルフサービス登録や即時キー発行はあえて用意していません — お客様(個別対応によるオンボーディング)と当社(データ利用の管理)の双方を守るためです。