Interface to the Numerai Machine Learning Tournament API

Routines to interact with the Numerai Machine Learning Tournament API <>. The functionality includes the ability to automatically download the current tournament data, submit predictions, and to get information for your user. General 'GraphQL' queries can also be executed.

Travis-CI Build Status

This interface allows download of tournament data, submit predictions, get user information, stake NMR's and much more. Using the functions from this package end user can write R code to automate the whole procedure related to numerai tournament.

If you encounter a problem or have suggestions, feel free to open an issue.


  • For the latest stable release: install.packages("Rnumerai")
  • For the latest development release: devtools::install_github("Omni-Analytics-Group/Rnumerai")

Automatic submission using this package

1. Load the package.

  • library(Rnumerai)

2. Set working directory where data will be downloaded and submission files would be kept.

  • Use current working directory

    data_dir <- getwd()

  • Or use temporary directory

    data_dir <- tempdir()

  • Or use a user specific directory

    data_dir <- "~/OAG/numerai"

3. Set Public Key and Secret API key variables.

Get your public key and api key by going to and then going to Custom API Keys section under your Account Tab. Select appropriate scopes to generate the key or select all scopes to use the full functionality of this package.

  • set_public_id("public_id_here")
  • set_api_key("api_key_here")

Optional: If we choose not to setup the credentials here the terminal will interactively prompt us to type the values when we make an API call.

4. Download data set for the current tournament and split it into training data and tournament data

  • data <- download_data(data_dir)
  • data_train <- data$data_train
  • data_tournament <- data$data_tournament

5. Generate predictions

A user can put his/her own custom model code to generate the predictions here. For demonstration purposes, we will generate random predictions.

  • submission <- data.frame(id=data_tournament$id,probability = sample(seq(.35,.65,by=.1),nrow(data_tournament),replace=TRUE))

6. Submit predictions and get submission id

  • submission_id <- submit_predictions(submission, data_dir)

7. Check the status of the submission (Wait for a few seconds to get the submission evaluated)

  • Sys.sleep(10) ## 10 Seconds wait period
  • status_submission_by_id(submission_id)

8. Stake submission on submission made above and get transaction hash for it.

  • stake_tx_hash <- stake_nmr(value = 1, confidence = ".5")
  • stake_tx_hash

Additional functions

1. Get User information

Get user information for the user whose API key and ID are entered, Check out the name of the return object to see what informations are included in the return and than subset the required information

  • uinfo <- user_info()
  • uinfo
  • names(uinfo)
  • uinfo$Latest_Submission

2. Get leaderboard for a round

Get leaderboard information for a given round number (Round 51 & Above).

  • round_info <- round_stats(round_number=79)
  • round_info$round_info
  • round_info$round_leaderboard

3. Get current open round

Get closing time and round number for current open round

  • current_round()

4. Run Custom GraphQL code from R:

  • custom_query <- 'query queryname { rounds (number:82) { closeTime } }'
  • run_query(query=custom_query)$data


Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


2.1 by Eric Hare, 4 months ago

Report a bug at

Browse source code at

Authors: Omni Analytics Group [aut] , Eric Hare [cre]

Documentation:   PDF Manual  

GPL-3 license

Imports httr, lubridate, dplyr, tidyr, ggplot2, purrr

See at CRAN