Skip to content

Latest commit

 

History

History
 
 

python

README.md

swagger-client

REST API for the BitMEX Trading Platform View Changelog - #### Getting Started Base URI: https://www.bitmex.com/api/v1 ##### Fetching Data All REST endpoints are documented below. You can try out any query right from this interface. Most table queries accept count, start, and reverse params. Set reverse=true to get rows newest-first. Additional documentation regarding filters, timestamps, and authentication is available in the main API documentation. All table data is available via the Websocket. We highly recommend using the socket if you want to have the quickest possible data without being subject to ratelimits. ##### Return Types By default, all data is returned as JSON. Send ?_format=csv to get CSV data or ?_format=xml to get XML data. ##### Trade Data Queries This is only a small subset of what is available, to get you started. Fill in the parameters and click the Try it out! button to try any of these queries. - Pricing Data - Trade Data - OrderBook Data - Settlement Data - Exchange Statistics Every function of the BitMEX.com platform is exposed here and documented. Many more functions are available. ##### Swagger Specification ⇩ Download Swagger JSON - ## All API Endpoints Click to expand a section.

This Python package is automatically generated by the Swagger Codegen project:

  • API version: 1.2.0
  • Package version: 1.0.0
  • Build package: io.swagger.codegen.languages.PythonClientCodegen

Requirements.

Python 2.7 and 3.4+

Installation & Usage

pip install

If the python package is hosted on Github, you can install directly from Github

pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git)

Then import the package:

import swagger_client

Setuptools

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import swagger_client

Getting Started

Please follow the installation procedure and then run the following:

from __future__ import print_function
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure API key authorization: apiExpires
configuration = swagger_client.Configuration()
configuration.api_key['api-expires'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['api-expires'] = 'Bearer'
# Configure API key authorization: apiKey
configuration = swagger_client.Configuration()
configuration.api_key['api-key'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['api-key'] = 'Bearer'
# Configure API key authorization: apiSignature
configuration = swagger_client.Configuration()
configuration.api_key['api-signature'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['api-signature'] = 'Bearer'

# create an instance of the API class
api_instance = swagger_client.APIKeyApi(swagger_client.ApiClient(configuration))
reverse = false # bool | If true, will sort results newest first. (optional) (default to false)

try:
    # Get your API Keys.
    api_response = api_instance.a_pi_key_get(reverse=reverse)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling APIKeyApi->a_pi_key_get: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to https://www.bitmex.com/api/v1

Class Method HTTP request Description
APIKeyApi a_pi_key_get GET /apiKey Get your API Keys.
AnnouncementApi announcement_get GET /announcement Get site announcements.
AnnouncementApi announcement_get_urgent GET /announcement/urgent Get urgent (banner) announcements.
ChatApi chat_get GET /chat Get chat messages.
ChatApi chat_get_channels GET /chat/channels Get available channels.
ChatApi chat_get_connected GET /chat/connected Get connected users.
ChatApi chat_new POST /chat Send a chat message.
ExecutionApi execution_get GET /execution Get all raw executions for your account.
ExecutionApi execution_get_trade_history GET /execution/tradeHistory Get all balance-affecting executions. This includes each trade, insurance charge, and settlement.
FundingApi funding_get GET /funding Get funding history.
GlobalNotificationApi global_notification_get GET /globalNotification Get your current GlobalNotifications.
InstrumentApi instrument_get GET /instrument Get instruments.
InstrumentApi instrument_get_active GET /instrument/active Get all active instruments and instruments that have expired in <24hrs.
InstrumentApi instrument_get_active_and_indices GET /instrument/activeAndIndices Helper method. Gets all active instruments and all indices. This is a join of the result of /indices and /active.
InstrumentApi instrument_get_active_intervals GET /instrument/activeIntervals Return all active contract series and interval pairs.
InstrumentApi instrument_get_composite_index GET /instrument/compositeIndex Show constituent parts of an index.
InstrumentApi instrument_get_indices GET /instrument/indices Get all price indices.
InsuranceApi insurance_get GET /insurance Get insurance fund history.
LeaderboardApi leaderboard_get GET /leaderboard Get current leaderboard.
LeaderboardApi leaderboard_get_name GET /leaderboard/name Get your alias on the leaderboard.
LiquidationApi liquidation_get GET /liquidation Get liquidation orders.
OrderApi order_amend PUT /order Amend the quantity or price of an open order.
OrderApi order_amend_bulk PUT /order/bulk Amend multiple orders for the same symbol.
OrderApi order_cancel DELETE /order Cancel order(s). Send multiple order IDs to cancel in bulk.
OrderApi order_cancel_all DELETE /order/all Cancels all of your orders.
OrderApi order_cancel_all_after POST /order/cancelAllAfter Automatically cancel all your orders after a specified timeout.
OrderApi order_close_position POST /order/closePosition Close a position. [Deprecated, use POST /order with execInst: 'Close']
OrderApi order_get_orders GET /order Get your orders.
OrderApi order_new POST /order Create a new order.
OrderApi order_new_bulk POST /order/bulk Create multiple new orders for the same symbol.
OrderBookApi order_book_get_l2 GET /orderBook/L2 Get current orderbook in vertical format.
PositionApi position_get GET /position Get your positions.
PositionApi position_isolate_margin POST /position/isolate Enable isolated margin or cross margin per-position.
PositionApi position_transfer_isolated_margin POST /position/transferMargin Transfer equity in or out of a position.
PositionApi position_update_leverage POST /position/leverage Choose leverage for a position.
PositionApi position_update_risk_limit POST /position/riskLimit Update your risk limit.
QuoteApi quote_get GET /quote Get Quotes.
QuoteApi quote_get_bucketed GET /quote/bucketed Get previous quotes in time buckets.
SchemaApi schema_get GET /schema Get model schemata for data objects returned by this API.
SchemaApi schema_websocket_help GET /schema/websocketHelp Returns help text & subject list for websocket usage.
SettlementApi settlement_get GET /settlement Get settlement history.
StatsApi stats_get GET /stats Get exchange-wide and per-series turnover and volume statistics.
StatsApi stats_history GET /stats/history Get historical exchange-wide and per-series turnover and volume statistics.
StatsApi stats_history_usd GET /stats/historyUSD Get a summary of exchange statistics in USD.
TradeApi trade_get GET /trade Get Trades.
TradeApi trade_get_bucketed GET /trade/bucketed Get previous trades in time buckets.
UserApi user_cancel_withdrawal POST /user/cancelWithdrawal Cancel a withdrawal.
UserApi user_check_referral_code GET /user/checkReferralCode Check if a referral code is valid.
UserApi user_communication_token POST /user/communicationToken Register your communication token for mobile clients
UserApi user_confirm POST /user/confirmEmail Confirm your email address with a token.
UserApi user_confirm_withdrawal POST /user/confirmWithdrawal Confirm a withdrawal.
UserApi user_get GET /user Get your user model.
UserApi user_get_affiliate_status GET /user/affiliateStatus Get your current affiliate/referral status.
UserApi user_get_commission GET /user/commission Get your account's commission status.
UserApi user_get_deposit_address GET /user/depositAddress Get a deposit address.
UserApi user_get_execution_history GET /user/executionHistory Get the execution history by day.
UserApi user_get_margin GET /user/margin Get your account's margin status. Send a currency of &quot;all&quot; to receive an array of all supported currencies.
UserApi user_get_quote_fill_ratio GET /user/quoteFillRatio Get 7 days worth of Quote Fill Ratio statistics.
UserApi user_get_wallet GET /user/wallet Get your current wallet information.
UserApi user_get_wallet_history GET /user/walletHistory Get a history of all of your wallet transactions (deposits, withdrawals, PNL).
UserApi user_get_wallet_summary GET /user/walletSummary Get a summary of all of your wallet transactions (deposits, withdrawals, PNL).
UserApi user_logout POST /user/logout Log out of BitMEX.
UserApi user_min_withdrawal_fee GET /user/minWithdrawalFee Get the minimum withdrawal fee for a currency.
UserApi user_request_withdrawal POST /user/requestWithdrawal Request a withdrawal to an external wallet.
UserApi user_save_preferences POST /user/preferences Save user preferences.
UserEventApi user_event_get GET /userEvent Get your user events

Documentation For Models

Documentation For Authorization

apiExpires

  • Type: API key
  • API key parameter name: api-expires
  • Location: HTTP header

apiKey

  • Type: API key
  • API key parameter name: api-key
  • Location: HTTP header

apiSignature

  • Type: API key
  • API key parameter name: api-signature
  • Location: HTTP header

Author

[email protected]