HotBits API Keys

In order to obtain random data generated by the HotBits radioactive random number generator, you must request an API Key using the API Key Request Form. (“API” stands for “Application Programming Interface”.) Once you receive your API Key, enter it in the box whenever you request random data from HotBits. If you request data from within a program with a URL, the API key is specified by a query field in the URL like:

?apikey=HB10usUsPFyJzKs84zYML85sbBY

Replace the example key (all keys begin with “HB1”) with the key you are issued.

You do not need an API Key to request pseudorandom data. If the “Pseudorandom data?” box is checked or you enter an API Key of “Pseudorandom”, HotBits will return data generated by a high-quality pseudorandom number generator which is seeded from HotBits radioactive-generated data. Pseudorandom data suffice for the vast majority of applications and not only may you obtain it without an API Key, there are no limits on the amount of data you can download within a 24 hour period.

An API key is required to obtain radioactively-generated random data because the hardware generators produce only around 100 bytes per second, and this generation rate can be exhausted if they are bombarded with a large number of requests. For more than twenty years, constrained only by a daily quota system enforced by IP address, HotBits users behaved responsibly and there were no problems, but recently, as the Internet Slum continues to become more coarse and stupid, distributed denial of service attacks against HotBits have become increasingly common. Requiring an API Key deters casual bad actors from using the resource in the first place and, more importantly, allows easily shutting off access to any user who behaves irresponsibly, even if they are accessing the site from numerous IP addresses.

When you obtain an API Key, do not publish it or loan it to others. Doing so runs the risk that, should they misbehave and abuse HotBits, the key may be revoked, blocking your own access to the site.

Request API Key

HotBits Main Page