Skip to content

Home

Jump to bottom
@_P_E_N_T_A edited this page Apr 7, 2020 · 23 revisions

インストール

方法1: パスの通った場所にシンボリックリンクを貼る(おすすめ)

少し行儀の悪い方法ですが、おそらく一番トラブルの少ない方法です。

  1. パスの通っている場所を調べる。
$ python3 -c 'import sys; print(sys.path)'
['', '/usr/lib/python38.zip', '/usr/lib/python3.8', '/usr/lib/python3.8/lib-dynload',
 '/home/sk/.local/lib/python3.8/site-packages', '/usr/lib/python3.8/site-packages']
  1. どこでも良いので（できれば管理者権限の必要ないディレクトリ）にbotfwのシンボリックリンクを作成。
$ cd /home/sk/.local/lib/python3.8/site-packages  # pip install --user で使われるディレクトリ
$ ln -s /path/to/btc_bot_framework/botfw botfw

方法2: PYTHONPATHにプロジェクトディレクトリを追加

使用しているシェルの設定ファイル(.bashrc, .zshrc等)にPYTHONPATHを追加します。
正しい作法ですが、IDEによってはlinterのエラーがでたり、自動補完が効かなかったりします

export PYTHONPATH="/path/to/btc_bot_framework:$PYTHONPATH"

方法3: インストールしない

プロジェクト内に直接コードを書いて、プロジェクトルートからモジュールとして実行する場合は
特にインストール作業は必要ありません。
例えば、samples/bitflyer/orderbook.pyなら以下のように実行できます。(__init__.pyが必要かも)

$ python3 -m samples.bitflyer.orderbook

マニュアル

概要

定数値一覧

Order Type

注文形式。create_order()のtypeに指定する値です。

  • LIMIT (='limit')
    指値注文。priceで価格を指定してください。
  • MARKET (='market')
    成行注文。priceは不要です。

Order Side

注文の売り又は買い。create_order()のsideに指定する値です。

  • BUY (='buy')
    買い注文。
  • SELL (='sell')
    売り注文。

Order State

注文クラスのstate変数にセットされる値。

  • OPEN (='open')
    注文が有効（部分約定含む）である状態。
  • CLOSED (='closed')
    注文が全て約定した状態。
  • CANCELED (='canceled')
    注文が失効もしくはキャンセル（部分約定含む）された状態。
  • WAIT_OPEN (='wait_open')
    注文が送信されて、受付待ちの状態。
  • WAIT_CANCEL (='wait_cancel')
    注文のキャンセルを送信して、キャンセル待ちの状態。

Order Event

注文に変化があった際に通知されるイベントです。

  • EVENT_EXECUTION (='execution')
    （部分）約定通知。
  • EVENT_OPEN (='open')
    注文の受付完了。
  • EVENT_CANCEL (='cancel')
    注文のキャンセル完了。
  • EVENT_OPEN_FAILED (='open_failed')
    注文の受付失敗。
  • EVENT_CANCEL_FAILED (='cancel_failed')
    注文のキャンセル失敗。
  • EVENT_CLOSE (='close')
    注文の全約定によるクローズ。取引所によっては通知されません。
  • EVENT_ERROR (='error')
    エラー通知。

取引所共通クラス一覧

各取引所のクラスは共通のベースクラスを継承して以下のように定義されています。
{Exchange}の部分はそれぞれの取引所の名称に置き換えて考えてください。

{Exchange}

このクラスは取引所毎に異なるクラスの名称を共通の名前にエイリアスし、初期化処理を共通化するためのものです。
例えば、bitflyerの場合、以下のように定義されています。

class Bitflyer(ExchangeBase):
    Api = BitflyerApi
    Websocket = BitflyerWebsocket
    OrderManager = BitflyerOrderManager
    OrderGroupManager = BitflyerOrderGroupManager
    Trade = BitflyerTrade
    Orderbook = BitflyerOrderbook

{Exchange}Api

ccxtを継承したクラスで通常のccxtメソッドに加えて、追加のメソッドとAPIの呼び出し回数を勘定する機能を提供します。
このクラスは主に内部で使用されるものなので、apiの余力を確認する以外の目的で参照することは基本的にありません。

{Exchange}Websocket

websocketのコネクションを管理するクラスです。
内部で利用するクラスなので直接利用することはありません。

{Exchange}OrderManager

内部的に注文を管理するためのクラスです。

{Exchange}OrderGroupManager

OrderGroupの生成と管理を行うクラスです。

{Exchange}PositionGroup

ポジション管理・損益計算を行うクラスで、OrderGroupの内部で利用されます。

{Exchange}OrderGroup

OrderGroupManagerによって生成されるクラスで、このクラスから注文とキャンセルを行います。

{Exchange}Trade

約定情報を提供するクラスです。
websocketで受信したデータを予め設定したコールバック関数に約定毎に渡します。

  • add_callback(cb)
    約定データを受信した際に呼び出されるコールバック関数（引数: ts, price, size）を指定します。 コールバック関数は複数追加可能ですが、websocketのスレッドから登録した順に呼び出されるため、ブロッキングする処理は避けてください。
  • remove_callback(cb)
    add_callbackで追加したコールバック関数を削除します。 メソッド変数はインスタンス経由で参照する度にidが変わるため、コールバック関数として追加したメソッドを後から削除する場合は、予めadd_callbackする際に変数に控えておいてください。
cb = obj.method
trade.add_callback(cb)

# trade.remove_callback(obj.method) # これは正常に動作しない
trade.remove_callback(cb) # 正常にコールバック関数を削除できる

{Exchange}Orderbook

板情報を提供するクラスです。
websocketで受信したデータを買い板(bids)と売り板(asks)に適切にソートして保持します。

  • bids() ! 買い板のリスト（正確にはビューオブジェクト）を返します。 価格が高い順（best bidが先頭）に[price, size]の形式で格納されています。
  • asks()
    売り板のリスト（正確にはビューオブジェクト）を返します。 価格が低い順（best askが先頭）に[price, size]の形式で格納されています。
  • add_callback(cb)
    板が更新された際に呼び出されるコールバック関数（引数なし）を追加します。 コールバック関数は複数追加可能ですが、websocketのスレッドから登録した順に呼び出されるため、ブロッキングする処理は避けてください。
  • remove_callback(cb)
    add_callbackで追加したコールバック関数を削除します。 メソッド変数はインスタンス経由で参照する度にidが変わるため、コールバック関数として追加したメソッドを後から削除する場合は、予めadd_callbackする際に変数に控えておいてください。

その他クラス一覧

取引所固有の仕様

bitbank

bitflyer

binance

bitmex

bybit

gmocoin

liquid

コーディングスタイル

  • 多少コードが冗長になる場合でも、基本的には設計上の正しさを優先します。

  • フレームワーク部分（botfw）については以下の規則を適用します。

    • pep8に準拠。ただし__init__.pyは例外
    • コメントを含めて英語(askiiコードのみ)で記述。それ以外のsampleやgitログ等は自由。

  • メソッド名や引数の変数名とその順序、また定数変数（全部大文字の変数）の内部値は可能な限りccxtと揃えます。

    • 'FX_BTC_JPY'(bitflyer) -> 'FX_BTC_JPY'(ccxt)
    • 'BTC_JPY(bitflyer) -> 'BTC/JPY'(ccxt)
    • 'BUY'(bitflyer), 'Buy'(bitmex), 'BUY'(binance) -> 'buy'(ccxt)
    • 'LIMIT'(bitflyer), 'Limit'(bitmex), 'LIMIT'(binance) -> 'limit'(ccxt)

  • メソッド名の英単語は省略しませんが、変数名、及び引数名は意味の分かる範囲内で自由に省略します。

  • 日本語部分（サンプルコード、README）を含め、全角スペース全面禁止

重要な変更点

commit 161 (9537ca0a8404e68d4021eac02c86d675492e0545) ----------

  • 注文・キャンセルを非同期（デフォルト）に変更。同期はsync=Trueを引数に渡す。
  • simulation mode 実装
  • liquid 追加
  • OrderGroupの注文一覧(orders)を削除。代わりにget_orders()を追加。
  • 変数名commissionをfeeに変更。手数料周りの実装を共通化。

commit 217 (6667332febf181d03ad7f77f15600de9f82a6bb8) ----------

  • bitflyer web注文API 削除

commit 251 (b453d933ee80907ff7bfec3b18894f63088d69ae) ----------

目次

Clone this wiki locally