Skip to content

Latest commit

 

History

History
189 lines (119 loc) · 8.9 KB

README.md

File metadata and controls

189 lines (119 loc) · 8.9 KB
Raw

API Client for Deribit API

Description

The Deribit API is available in this package.

Installation

sudo pip install deribit-api

Example

from deribit_api import RestClient
client = RestClient("KEY", "SECRET")
client.index()
client.account()

API - REST Client

new RestClient(key, secret, url)

Constructor creates new REST client.

Parameters

Name Type Decription
key string Optional, Access Key needed to access Private functions
secret string Optional, Access Secret needed to access Private functions
url string Optional, server URL, default: https://www.deribit.com

Methods

  • getorderbook(instrument) - Doc, public

    Retrieve the orderbook for a given instrument.

    Parameters

    Name Type Decription
    instrument string Required, instrument name

  • index() - Doc, public

    Get price index, BTC-USD rates.

  • getcurrencies() - Doc, public

    Get all supported currencies.

  • getorderbook(instrument) - Doc, public

    Retrieve the orderbook for a given instrument.

    Parameters

    Name Type Decription
    instrument string Required, instrument name

  • getlasttrades(instrument, count, since) - Doc, public

    Retrieve the latest trades that have occured for a specific instrument.

    Parameters

    Name Type Decription
    instrument string Required, instrument name
    count integer Optional, count of trades returned (limitation: max. count is 100)
    since integer Optional, “since” trade id, the server returns trades newer than that “since”

  • getsummary(instrument) - Doc, public

    Retrieve the summary info such as Open Interest, 24H Volume etc for a specific instrument.

    Parameters

    Name Type Decription
    instrument string Required, instrument name

  • account() - Doc, Private

    Get user account summary.

  • buy(instrument, quantity, price, postOnly, label) - Doc, private

    Place a buy order in an instrument.

    Parameters

    Name Type Decription
    instrument string Required, instrument name
    quantity integer Required, quantity, in contracts ($10 per contract for futures, ฿1 — for options)
    price float Required, USD for futures, BTC for options
    postOnly boolean Optional, if true then the order will be POST ONLY
    label string Optional, user defined maximum 4-char label for the order

  • sell(instrument, quantity, price, postOnly, label) - Doc, private

    Place a sell order in an instrument.

    Parameters

    Name Type Decription
    instrument string Required, instrument name
    quantity integer Required, quantity, in contracts ($10 per contract for futures, ฿1 — for options)
    price float Required, USD for futures, BTC for options
    postOnly boolean Optional, if true then the order will be POST ONLY
    label string Optional, user defined maximum 4-char label for the order

  • edit(orderId, quantity, price) - Doc

    Edit price and/or quantity of the own order. (Authorization is required).

    Parameters

    Name Type Decription
    orderId integer Required, ID of the order returned by "sell" or "buy" request
    quantity integer Required, quantity, in contracts ($10 per contract for futures, ฿1 — for options)
    price float Required, USD for futures, BTC for options

  • cancel(orderId) - Doc, private

    Cancell own order by id.

    Parameters

    Name Type Decription
    orderId integer Required, ID of the order returned by "sell" or "buy" request

  • cancelall(type) - Doc

    Cancel all own futures, or all options, or all.

    Parameters

    Name Type Decription
    type string Optional, type of instruments to cancel, allowed: "all", "futures", "options", default: "all"

  • getopenorders(instrument, orderId) - Doc, private

    Retrieve open orders.

    Parameters

    Name Type Description
    instrument string Optional, instrument name, use if want orders for specific instrument
    orderId integer Optional, order id

  • positions() - Doc, private

    Retreive positions.

  • orderhistory(count) - Doc, private

    Get history.

    Parameters

    Name Type Description
    count integer Optional, number of requested records

  • tradehistory(count, instrument, startTradeId) - Doc, private

    Get private trade history of the account. (Authorization is required). The result is ordered by trade identifiers (trade id-s).

    Parameters

    Name Type Description
    count integer Optional, number of results to fetch. Default: 20
    instrument string Optional, name of instrument, also aliases “all”, “futures”, “options” are allowed. Default: "all"
    startTradeId integer Optional, number of requested records