暗号資産（仮想通貨） ＞ 取引所API

仮想通貨APIの使い方｜国内4社比較・Pythonで価格取得

最終更新日：2026年9月24日

制作・編集：金融ナンバーワンサイト

仮想通貨APIは、プログラムから価格や取引記録を読み、許可した範囲で注文もできる接続口です。価格を見るだけなら、口座やAPIキーなしで試せます。自分の残高を読むときや注文するときは、認証と権限の設定が必要です。

APIは操作を自動化する道具です。利益や約定を保証するものではなく、相場変動や誤発注、通信障害で損失が出ることがあります。

APIキーなしでビットコインの価格を取得する

最初は注文を出さず、公開されている価格を1回読むところから始めましょう。以下はGMOコインのPublic API「最新レート」を使う例です。Python 3の標準ライブラリだけを使い、口座・APIキー・追加パッケージは不要です。GMOコインを売買先として推奨する例ではありません。

1. 応答を見てみる：現物BTCの公開データをブラウザで開くと、JSON形式のデータを確認できます。
2. Pythonで読む：下のコードを price.py として保存し、Python 3を使える環境で python price.py を実行します。環境によっては python3 price.py です。
3. 値と時刻を確かめる：正常時は4項目を表示します。取得できないときは値を表示せず終了します。エラーや空の応答を0円として保存しないでください。

import json
from urllib.request import urlopen

# GMOコインの現物BTC。認証なしで1回だけ取得します。
url = "https://api.coin.z.com/public/v1/ticker?symbol=BTC"
try:
    with urlopen(url, timeout=10) as response:
        payload = json.load(response)
    if payload.get("status") != 0:
        raise ValueError("APIがエラーを返しました")
    ticker = next(x for x in payload["data"] if x["symbol"] == "BTC")
    fields = ("last", "ask", "bid", "timestamp")
    if any(not isinstance(ticker[k], str) or not ticker[k] for k in fields):
        raise ValueError("必要な値を取得できませんでした")
except (OSError, ValueError, KeyError, TypeError, AttributeError, StopIteration):
    raise SystemExit("取得できませんでした。値を使わず終了します。")

print("最終取引価格（円）:", ticker["last"])
print("売りの最良気配値（円）:", ticker["ask"])
print("買いの最良気配値（円）:", ticker["bid"])
print("約定時刻（UTC）:", ticker["timestamp"])

このAPIの BTC は現物、BTC_JPY はレバレッジ取引です。同じビットコインでも市場を混ぜないようにします。価格は文字列で返るため、この例では丸めずにそのまま表示します。

仮想通貨APIとは｜3種類を先に分ける

検索で「仮想通貨API」と呼ばれるものは一つではありません。価格を集めるサービスと、取引所口座を操作するAPIを混同すると、必要な機能もリスクも判断できません。

Public／PrivateとREST／リアルタイム配信の違い

国内取引所APIの公式仕様を4社比較

比較対象は、公式API文書が継続公開されているbitbank、GMOコイン、bitFlyer、Coincheckの4社です。国内のAPI提供会社を網羅した順位表ではありません。BitTrade、Zaif、OKJ等にもAPIがあるため、利用したい市場や機能が4社にない場合は各社公式文書も確認してください。

レート制限は全エンドポイントの完全な一覧ではありません。bitFlyerの小口注文など個別条件もあります。CoincheckはAPI文書と2026年4月23日の取引説明書で注文頻度の表現が一致しないため、本ページは現行API文書の4回/秒を採用し、実装直前の再確認を前提としています。上限ぎりぎりの送信を目標にせず、429時の待機を組み込みます。

4社のAPIで確認するポイント

用途別に必要なAPIを決める

取引所名より先に決める7条件

• 市場とペア：現物、信用、レバレッジ、CFDのどれを使い、どのペアを注文するか。
• 注文方式：指値・成行・特殊注文、取消、注文詳細、約定通知まで必要か。
• データ方式：定期取得で足りるか、リアルタイム配信とPrivateイベントが必要か。
• 被害範囲：参照・取引・送付・出金のどこまでキーに許可し、IPを限定できるか。
• 呼出予算：監視ペア数と更新間隔から必要回数を計算し、上限と余裕を確保できるか。
• 復旧手段：429、タイムアウト、配信切断、メンテナンス後に注文状態を照合できるか。
• コスト：Maker／Taker、スプレッド、維持費、サーバー・監視費を含めて運用できるか。

仮想通貨APIを始める8ステップ

1. 目的と停止条件を決める：データ取得だけか、残高照会か、実注文かを分け、1注文数量・保有量・注文回数・損失の上限を数値で決めます。
2. 公式仕様を保存する：対象エンドポイント、認証、パラメータ、エラー、レート制限、変更履歴、メンテナンス情報を確認します。
3. Public APIで接続する：まずキーを使わず、価格取得、タイムアウト、429、JSONの欠損・型変更を処理します。
4. ローカルで擬似約定する：取得した価格を使って売買判定と記録だけを動かし、実注文を送らずに数量・手数料・停止条件を検証します。
5. 用途別のキーを発行する：参照用と取引用を分け、使わない送付・出金権限は付けません。対応する場合は接続元IPを限定します。
6. 秘密情報と時刻を管理する：シークレットをソースコード、Git、画面、ログへ残さず、サーバー時刻とnonce／timestampを管理します。
7. 監視下で小さく確認する：実注文が必要な場合は公式最小数量と許容損失を確認し、すぐ停止・取消・照合できる時間帯に限定します。
8. 監視と更新を続ける：注文状態、残高、エラー率、429、配信切断を監視し、仕様変更や利用終了時にキーを無効化します。

APIキーの漏えいと誤発注を抑える設定

APIキーが漏えいした疑いがあるとき

1. 停止
   botと外部連携を止める
2. 無効化
   該当キーを削除・失効
3. 照合
   注文・約定・送付・出金を確認
4. 保護
   口座認証と端末を点検
5. 連絡
   不審履歴を取引所へ相談

キーを無効化した後、残高、未約定注文、約定、送付・出金履歴を公式画面で照合します。アカウント自体の侵害が疑われる場合は、公式窓口の案内に従ってパスワード、2段階認証、登録端末も見直します。時刻、IP、注文ID、ログを保全し、秘密情報そのものは問い合わせ文へ貼り付けません。口座全体の対策は仮想通貨のセキュリティ対策で確認できます。

自動売買botで防ぐ6つの運用事故

注文受付から残高照合までを1単位にする

1. 事前確認
   status・残高・上限
2. 注文送信
   要求IDと時刻を保存
3. 受付記録
   注文IDと応答を保存
4. 状態照合
   約定量・残量・取消
5. 残高照合
   手数料込みで更新

各処理に一意の内部IDを付け、同じ売買シグナルを二重処理しないようにします。取引所がidempotency keyを提供しているとは限らないため、自分の側でシグナルID、注文ID、状態遷移を保存し、不明状態を解消するまで次の注文を止めます。

自動売買botと自動積立は別の仕組み

定額購入が目的なら、APIを作る前にビットコイン自動積立の比較を確認してください。板取引と販売所の違いは取引所と販売所の仕組みで整理しています。

API運用で見落としやすい費用と記録

「APIを呼べるか」と「取引コストが低いか」は別の問題です。API利用料の有無だけでなく、売買、ポジション維持、入出金、インフラ、監視の総額を見ます。会社・銘柄・注文方式・取引量で変わる料率は、仮想通貨取引所の手数料比較と各社の最新料金表で確認してください。

秘密情報を除いて残す記録

• 要求：内部ID、エンドポイント、送信時刻、注文条件
• 応答：HTTP状態、エラーコード、取引所の注文ID
• 状態：未約定、部分約定、約定、取消、失効と更新時刻
• 数量：注文量、約定量、残量、平均価格、手数料
• 残高：処理前後の資産・拘束額と照合結果
• 運用：429、切断、再接続、停止・再開、仕様バージョン

APIキー、シークレット、署名元データをそのままログへ残しません。損益計算サービスへ渡す場合は参照権限に絞り、取得できる期間や取引の種類を確認します。API連携だけで過去の全取引がそろうとは限りません。足りない記録は取引所の履歴やCSVと照合し、取引履歴をまとめて損益計算・確定申告を進める手順へ進んでください。課税の考え方は仮想通貨の税金にまとめています。

確認した主な公式API情報

各社の仕様、対応市場、権限、上限、メンテナンス条件は変更されます。実装・利用時点の公式ドキュメント、変更履歴、利用規約、取引画面を確認してください。

まとめ｜API対応より「止めて照合できるか」を重視する

仮想通貨APIは、公開データの取得から口座の注文まで幅広い機能を持ちます。まず市場データAPIと取引所API、PublicとPrivate、RESTとリアルタイム配信を分けます。そのうえで、必要な市場・注文・権限・上限を公式仕様で確認し、取引所名の順位ではなく自分の要件に合うかを判断します。