Upbitの履歴k-lineデータをエクスポートする方法は？

upbitの履歴k-lineデータをエクスポートするには、Pythonをセットアップし、Upbit APIのキャンドルエンドポイントを使用し、ページネーションを処理し、データをCSV形式で保存します。

2025/04/15 21:01

Upbitの履歴k-lineデータをエクスポートする方法は？

Upbitからの履歴K-Lineデータのエクスポートは、市場動向を調査し、情報に基づいた取引決定を下す必要があるトレーダーやアナリストにとって重要です。韓国で最大の暗号通貨交換の1つであるUpbitは、APIを通じてアクセスできる豊富なデータを提供します。この記事では、Upbitの履歴Kラインデータを詳細にエクスポートするプロセスをご案内します。

UpbitのAPIの理解

データをエクスポートするための手順に飛び込む前に、UpbitのAPIの基本を理解することが重要です。 UpbitのAPIを使用すると、ユーザーはリアルタイムおよび履歴市場データにアクセスし、注文を配置し、プログラムでアカウントを管理できます。履歴K-Lineデータをエクスポートするために、 Candles Endpointに焦点を当てます。これは、Candlestickデータの形で必要な情報を提供します。

環境を設定します

まず、開発環境を設定する必要があります。ここにそうするための手順があります：

• Pythonのインストール：システムにPythonがインストールされていることを確認してください。まだ公式のWebサイトからダウンロードできない場合は、ダウンロードできます。

• 必要なライブラリをインストールする：upbit APIにHTTPリクエストを作成するには、 requestsライブラリをインストールする必要があります。 PIPを使用してインストールできます。

   pip install requests

• APIアクセス：UpbitのWebサイトでAPIキーを作成する必要があります。 API管理セクションに移動し、新しいキーを作成し、APIキーと秘密を安全に保ちます。

APIリクエストを作成します

環境が設定されたら、APIリクエストの作成を開始して、履歴K-Lineデータを取得できます。これがそれを行う方法です：

• 必要なライブラリをインポート：Pythonスクリプトに必要なライブラリをインポートすることから始めます。

   import requests
   import json
   from datetime import datetime, timedelta

• APIエンドポイントの定義：キャンドルを取得するエンドポイントはhttps://api.upbit.com/v1/candles/minutes/{unit}です。ここでは、 {unit}は1、3、5、10、15、30、60、または240であり、各ろうそくの時間間隔を数分で表します。

• パラメーターの設定：市場（たとえば、 KRW-BTC ）、キャンドルユニット、日付範囲などのパラメーターを設定する必要があります。たとえば、過去24時間にわたってKRW-BTCの1分間のキャンドルを取得するには、次のようにパラメーターを設定できます。

   market = 'KRW-BTC'
   unit = 1
   to = datetime.now()
   from_ = to - timedelta(days=1)

• URLの構築：エンドポイントとパラメーターを組み合わせて、APIリクエストのURLを構築します。

   url = f'https://api.upbit.com/v1/candles/minutes/{unit}?market={market}&to={to.isoformat()}&count=200'

• リクエストの送信： requestsライブラリを使用して、構築されたURLにGETリクエストを送信します。

   response = requests.get(url)
   data = response.json()

データの処理と保存

データを受信した後、それを処理して適切な形式で保存する必要があります。これがそれを行う方法です：

• データの解析：受信したデータはJSON形式になります。それを解析し、タイムスタンプ、開口価格、高価格、低価格、終値、取引量などの関連情報を抽出できます。

   for candle in data: timestamp = candle['candle_date_time_utc'] opening_price = candle['opening_price'] high_price = candle['high_price'] low_price = candle['low_price'] closing_price = candle['trade_price'] volume = candle['candle_acc_trade_volume'] # Process the data as needed

• データの保存：処理されたデータをCSV、JSON、またはデータベースなどのさまざまな形式で保存できます。 CSVファイルとして保存する例は次のとおりです。

   import csv

  with open（ 'upbit_kline_data.csv'、 'w'、newline = ''）as csvfile：

   fieldnames = ['timestamp', 'opening_price', 'high_price', 'low_price', 'closing_price', 'volume'] writer = csv.DictWriter(csvfile, fieldnames=fieldnames) writer.writeheader() for candle in data: writer.writerow({ 'timestamp': candle['candle_date_time_utc'], 'opening_price': candle['opening_price'], 'high_price': candle['high_price'], 'low_price': candle['low_price'], 'closing_price': candle['trade_price'], 'volume': candle['candle_acc_trade_volume'] })

ページネーションの取り扱い

UpbitのAPIには、1回のリクエストで返されるキャンドルの数に制限があります。より多くのデータを取得するには、ページネーションを処理する必要があります。これがそれを行う方法です：

• 最初のリクエスト：前述のように初期リクエストを行います。

• より多くのデータを確認してください：応答の最後のキャンドルのタイムスタンプを見て、より多くのキャンドルが利用できるかどうかを確認してください。

• 後続のリクエスト：最後のキャンドルのタイムスタンプを使用して、次のリクエストを行います。 URL内のtoを、受け取った最後のキャンドルのタイムスタンプに更新します。

   while data: last_timestamp = data[-1]['candle_date_time_utc'] url = f'https://api.upbit.com/v1/candles/minutes/{unit}?market={market}&to={last_timestamp}&count=200' response = requests.get(url) new_data = response.json() if new_data: data.extend(new_data) else: break

エラー処理とベストプラクティス

APIを使用する場合、エラー処理を実装し、ベストプラクティスに従うことが重要です。ここにいくつかのヒントがあります：

• エラー処理：Try-Exceptブロックを使用して、ネットワークの問題やAPIレートの制限などの潜在的なエラーを処理します。

   try: response = requests.get(url) response.raise_for_status()

  requests.exceptions.requestexception as e：

   print(f'Error occurred: {e}')

• レートの制限：Upbitのレート制限に注意してください。レート制限のヒットを避けるために、必要に応じてリクエスト間の遅延を実装します。

   import time

  time.sleep（1）＃リクエストの合間に1秒待ってください

• データ検証：APIから受信したデータを検証して、期待を満たすことを確認します。

   if not data: print('No data received')

  それ以外：

  for candle in data: if 'candle_date_time_utc' not in candle: print('Invalid data format') break

よくある質問

Q：複数の暗号通貨の履歴k-lineデータを一度にエクスポートできますか？

A：UpbitのAPIは、単一のAPI呼び出しで複数の市場のバッチリクエストをサポートしていません。興味のある暗号通貨ごとに個別のリクエストを行う必要があります。

Q：upbitから履歴k-lineデータをどのくらい戻ることができますか？

A：アップビットは、ほとんどの市場で最大2年間履歴データを提供します。ただし、データの可用性は、特定の市場とキャンドルユニットによって異なる場合があります。

Q：1日あたりにできるAPIリクエストの数に制限はありますか？

A：はい、アップビットにはAPIにレート制限があります。正確な制限は、APIキータイプに依存します。ドキュメントをチェックし、これらの制限に衝突しないように、コードに適切なレート制限を実装することが重要です。

Q：商業目的でエクスポートされたデータを使用できますか？

A：Upbitのサービス利用規約およびAPI使用ポリシーを確認して、商業目的でデータを使用することに関する制限を理解することが不可欠です。常にポリシーを順守してください。