Token Ohlcv X402

トークンの OHLCV 履歴 API

あらゆるトークンの過去の OHLCV ローソク足データを取得できます。日足、4h、1h の間隔に対応しています。CoinGecko と GeckoTerminal を利用しています。x402 による従量課金（Base L2 上の USDC）で、API キーも登録も不要です。レート制限に悩まされることもありません。

klymax402 マーケットプレイスの一部です。AI エージェント向けの x402 マイクロペイメント API 100 種類を、1 つのウォレットと Base 上の USDC で利用できます。

クイックスタート -- MCP

MCP クライアントの設定（Claude Desktop、Cursor、ElizaOS など）に追加します。

{
  "mcpServers": {
    "token-ohlcv": {
      "url": "https://token-ohlcv.api.klymax402.com/mcp"
    }
  }
}

クイックスタート -- HTTP（x402）

curl "https://token-ohlcv.api.klymax402.com/api/candles"
# -> 402 Payment Required, with an x402 payment challenge in the response body

x402 対応クライアント（@x402/fetch、x402-agent-tools、ATXP）は、402 -> 署名 -> 再試行のサイクルを自動的に処理します。

ツール

ツール	メソッド	パス	価格	説明
token_get_ohlcv_history	GET	/api/candles	$0.005	ID またはコントラクトアドレスを指定して、あらゆるトークンの過去の OHLCV ローソク足データを取得します
token_get_ohlcv_history	POST	/api/candles	$0.005	ID またはコントラクトアドレスを指定して、あらゆるトークンの過去の OHLCV ローソク足データを取得します（POST 版）

token_get_ohlcv_history

あらゆるトークンの過去の価格ローソク足データが必要な場合に使用します。OHLCV ローソク足データを JSON で返します。

パラメーター

名前	型	必須	説明
token	string	いいえ	CoinGecko のトークン ID（例：bitcoin、ethereum、solana）。これを指定するか、contract と chain を指定します。
contract	string	いいえ	オンチェーンのコントラクトアドレス（例：0x...）。GeckoTerminal で検索するには chain パラメーターと併用します。
chain	string	いいえ	コントラクト検索に使用するブロックチェーンネットワーク：base、ethereum、solana、arbitrum、polygon、optimism、bsc。
days	number	いいえ	取得する履歴の日数（デフォルトは 30、最大 365）。1h 間隔では最大 2 日、4h 間隔では最大 90 日です。
interval	string	いいえ	ローソク足の間隔：daily（デフォルト）、4h（days が 90 以下の場合）、1h（days が 2 以下の場合）。

戻り値

• candles -- timestamp、open、high、low、close、volume を含むローソク足オブジェクトの配列
• token -- 使用されたトークン識別子
• interval -- ローソク足の間隔（daily、4h、1h）
• days -- 返された履歴の日数
• source -- データソース（CoinGecko または GeckoTerminal）

レスポンス例：

{"candles":[{"timestamp":1712966400,"open":3105.20,"high":3142.80,"low":3089.50,"close":3128.60,"volume":1250000000}],"token":"ethereum","interval":"daily","days":30,"source":"CoinGecko"}

用途：テクニカル分析、バックテスト、トレンド検出、チャート作成に適しています。CoinGecko ID または GeckoTerminal 経由のオンチェーンコントラクトアドレスを使って、10,000 以上のトークンに対応します。

用途外：スワップ見積もりには dex_get_swap_quote、ニュースには crypto_get_latest_news、資金調達率には perp_scan_funding_arbitrage を使用してください。

token_get_ohlcv_history

任意のトークンの過去の価格ローソク足データが必要な場合に使用します。OHLCV ローソク足データを JSON で返します。token_get_ohlcv_history の POST 版で、同じパラメーターをクエリ文字列ではなく JSON の本文として渡します。

パラメーター

名前	型	必須	説明
token	string	いいえ	CoinGecko のトークン ID（例：bitcoin、ethereum、solana）。これを使うか、contract と chain を使います。
contract	string	いいえ	オンチェーンのコントラクトアドレス（例：0x...）。GeckoTerminal で検索する場合は chain パラメーターと併用します。
chain	string	いいえ	コントラクト検索に使用するブロックチェーンネットワーク：base、ethereum、solana、arbitrum、polygon、optimism、bsc。
days	number	いいえ	履歴の日数（デフォルトは 30、最大 365）。1h 間隔では最大 2 日、4h では最大 90 日です。
interval	string	いいえ	ローソク足の間隔：daily（デフォルト）、4h（days <= 90 の場合）、1h（days <= 2 の場合）。

戻り値

• candles -- timestamp、open、high、low、close、volume を含むローソク足オブジェクトの配列
• token -- 使用されたトークン識別子
• interval -- ローソク足の間隔（daily、4h、1h）
• days -- 返された履歴の日数
• source -- データソース（CoinGecko または GeckoTerminal）

レスポンス例：

{"candles":[{"timestamp":1712966400,"open":3105.20,"high":3142.80,"low":3089.50,"close":3128.60,"volume":1250000000}],"token":"ethereum","interval":"daily","days":30,"source":"CoinGecko"}

使用する場面：テクニカル分析、バックテスト、トレンド検出、チャート作成。CoinGecko ID または GeckoTerminal 経由のオンチェーンコントラクトアドレスを使って、10,000 以上のトークンに対応しています。

用途外：スワップ見積もり（dex_get_swap_quote を使用）、ニュース（crypto_get_latest_news を使用）、資金調達率（perp_scan_funding_arbitrage を使用）。

エージェントのプロンプト例

• 「任意のトークンの過去の価格ローソク足データ」
• 「任意のトークンの過去の価格ローソク足データ」

支払い

• プロトコル：x402 -- HTTP ネイティブの従量課金制。登録も API キーも不要です
• ネットワーク：Base L2（eip155:8453）
• 資産：USDC
• ファシリテーター：Coinbase CDP（プライマリ）、PayAI（フォールバック）
• ATXP 経由でも利用できます（OAuth でラップされた x402、RFC 9728 保護リソースメタデータ）

klymax402 の一部

AI エージェント向けの x402 マイクロペイメント API 100 種類。ウォレットは 1 つ、Base 上の USDC を使用し、登録は不要です。

• カタログ：https://klymax402.com/llms.txt
• API リファレンス全文：https://klymax402.com/llms-full.txt
• ライブ統計：https://klymax402.com/stats

ライセンス

MIT