bitmexr - R Client for the bitmex exchange

R build status CRAN status


The goal of bitmexr is to provide an API wrapper for cryptocurrency derivatives exchange, BitMEX. bitmexr now provides support for all API endpoints for both the Testnet ( and the live exchange ( For more information about the API, check


The development version of bitmexr can be installed from github:

# install.packages("devtools")

Or the released version from CRAN:


Package contents

The package contains dedicated wrappers for the majority of API endpoints.

Additional API endpoints that do not have a dedicated wrapper can be accessed using get_bitmex() for GET requests and post_bitmex() for POST requests. For example use:

get_bitmex(path = "/chat", args = list(reverse = "false"))

to get the latest trollbox messages.

Testnet API

All functions in the package also work with BitMEX’s Testnet API. Simply use the “tn_” prefix to access the Testnet version of the function. For example tn_place_order() will place an order on the Testnet exchange.


Accessing private API endpoints, such as those to manage trades, requires an API key and secret. bitmexr reads these from your ~/.Renviron file - see vignette Authentication for more information.


This software is in no way affiliated, endorsed, or approved by the BitMEX cryptocurrency exchange or any of its affiliates.


If you spot any issues, or would like additional features added, please feel free to raise an issue, or submit a pull request.

Code of Conduct

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.