Access true random numbers through the API!

See for the specifics of the services and their API.

This project lives on Bitbucket: and is published on RubyGems:

AWS CodeBuild Bitbucket Pipelines Gem Documentation


Add this line to your application's Gemfile:

gem 'randomorg'

And then execute:

$ bundle

Or install it yourself as:

$ gem install randomorg


Before you can get your random numbers, you will need an API key. You can request one from here:

Then you need to configure the module with this key in order to use the service:

RandomOrg.configure do |config|
  config.api_key = "YOUR_API_KEY"

After which you can use it in pretty much the same way as you would the SecureRandom library:

> RandomOrg.random_number(100)
=> 78
> RandomOrg.base64
=> "r1nwqJksqKacn26UBI1GkQ=="


Bug reports and pull requests are welcome on Bitbucket at This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.


The gem is available as open source under the terms of the MIT License.

Use of the service and API is subject to their Terms and Conditions: