API Sandbox
The website uses data which is available for free and without any limitations under @komed3/rtb-api. If you are interested in getting a first impression on our data or would like to try out this API, you can use this sandbox. Follow through the descriptions and discover all available queries and various information. The latest version may not be available. Updates will take place several times a year.
Sandbox
Try an API input and get your answer in the message box below. Tips on how to use this API and any available queries are listed further down this page. Otherwise, you can check out the GitHub repository @komed3/rtb-api.
Try some requests:
Get the real-time list for 10/03/22: list/rtb/2022-10-03
Get profile information about Bill Gates: profile/bill-gates/info
Get winners in percent for 08/17/23: movers/pct/winner/2023-08-17
Get billionaires age pyramide: stats/agePyramid
Help & Usage
Requests can be done by using jsDelivr:
https://cdn.jsdelivr.net/gh/komed3/rtb-api@main/api/{REQUEST}
As {REQUEST} use one of the paths below.
Global
- availableDays
- Get available days for real-time billionaires list in CSV format.
- latest
- Get latest available day for real-time billionaires list.
- updated
- Get timestamp of the last update.
Profiles
- profile/_index
- Get a list of all profiles sorted by their URI in JSON format.
- profile/_alias
- Get a list of profile aliases in JSON format.
Single profile
The {URI} argument is described in the profiles index and is unique to each profile.
- profile/{URI}/info
- Get profile info in JSON format, e.g. name, residence education etc.
- profile/{URI}/bio
- Get biographical and additional facts about a profile in JSON format.
- profile/{URI}/assets
- Get financial assets of a profile in JSON format.
- profile/{URI}/rank
- Get ranking information in JSON format.
- profile/{URI}/latest
- Get the latest rank and net worth in JSON format.
- profile/{URI}/history
- Get historical rank and net worth information in CSV format.
- profile/{URI}/related
- Get related profiles in JSON format.
- profile/{URI}/annual
- Get annual reports for a profile in JSON format.
- profile/{URI}/updated
- Get the profile info update timestamp.
Lists
The {LIST} argument is described in the lists index. Use {DATE} format YYYY-MM-DD for available days.
- list/_index
- Get the index for available lists in JSON format.
- list/{LIST}/{DATE}
- Get the corresponding list by passed list key and date in JSON format.
- list/{LIST}/latest
- Get the newest available list by passed list key in JSON format.
Stats
The {KEY} argument is a valid country code (ISO) or industry key. Both are described by their corresponding indices.
- stats/count
- Get daily number of billionaires as CSV list.
- stats/total
- Get daily total net worth as CSV list.
- stats/woman
- Get daily number of woman billionaires as CSV list.
- stats/country/_index
- Get countries index in JSON format.
- stats/country/_list
- Get a CSV list of countries by number, fortune and richest individual.
- stats/country/{KEY}
- Get daily number, total net worth and richest individual as CSV list.
- stats/industry/_index
- Get industries index in JSON format.
- stats/industry/_list
- Get a CSV list of industries by number, fortune and richest individual.
- stats/industry/{KEY}
- Get daily number, total net worth and richest individual as CSV list.
- stats/agePyramid
- Get age pyramide (male/female) in JSON format.
- stats/children
- Get number of billionaires by their children in JSON format.
- stats/maritalStatus
- Get number of billionaires by their marital status in JSON format.
- stats/selfMade
- Get number of billionaires by their self-made score in JSON format.
- stats/top10
- Get top 10 richest billionaires for each month since January 2020.
Movers
Use {DATE} format YYYY-MM-DD for available days.
- movers/pct/winner/{DATE}
- Get winner in percent as of date in JSON format.
- movers/pct/winner/latest
- Get latest winner in percent in JSON format.
- movers/pct/winner/_list
- Get a daily CSV list top winner in percent.
- movers/pct/loser/{DATE}
- Get loser in percent as of date in JSON format.
- movers/pct/loser/latest
- Get latest loser in percent in JSON format.
- movers/pct/loser/_list
- Get a daily CSV list of top loser in percent.
- movers/value/winner/{DATE}
- Get winner in net worth as of date in JSON format.
- movers/value/winner/latest
- Get latest winner in net worth in JSON format.
- movers/value/winner/_list
- Get a daily CSV list of top winner in net worth.
- movers/value/loser/{DATE}
- Get loser in net worth as of date in JSON format.
- movers/value/loser/latest
- Get latest loser in net worth in JSON format.
- movers/value/loser/_list
- Get a daily CSV list of top loser in net worth.
Filter
The {KEY} argument is a valid country code (ISO) or industry key. Both are described by their corresponding indices.
- filter/_index
- Get index of all available filter in JSON format.
- filter/country/_index
- Get countries index in JSON format.
- filter/country/{KEY}
- Get a list of billionaires by country in JSON format.
- filter/industry/_index
- Get industries index in JSON format.
- filter/industry/{KEY}
- Get a list of billionaires by industry in JSON format.
- filter/woman
- Get a list of woman billionaires in JSON format.
- filter/young
- Get a list of young billionaires (under 50) in JSON format.
- filter/old
- Get a list of old billionaires (over 80) in JSON format.
- filter/selfMade
- Get a list of self-made billionaires in JSON format.
- filter/dropped
- Get a list of dropped off billionaires in JSON format.
- filter/deceased
- Get a list of deceased billionaires in JSON format.