Forbes API: Get billionaire net worth
Looks up a billionaire by name on the Forbes real-time billionaires list and returns their real-time net worth, today's change, rank and public profile details. Wealth figures change throughout the trading day.
Unofficial. Not affiliated with or endorsed by Forbes.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Name, required
name The billionaire's name, for example Elon Musk.
Elon Musk
Input as JSON
{ "name": "Elon Musk"}Output
{ "age": 55, "name": "Elon Musk", "rank": 1, "photo_url": "https://imageio.forbes.com/specials-images/imageserve/62d700cd6094d2c180f269b9/0x0.jpg?format=jpg&crop=959,959,x0,y0,safe&height=416&width=416&fit=bounds" , "residence": "Austin, Texas", "updated_at": "2026-09-28T22:45:02-04:00", "citizenship": "United States", "profile_url": "https://www.forbes.com/profile/elon-musk/" , "self_made_label": "Self-made who came from a middle-class or upper-middle-class background", "self_made_score": 8, "source_of_wealth": "Tesla, SpaceX, Self Made", "todays_change_percent": -2.39, "net_worth_billions_usd": 906.7, "todays_change_billions_usd": -22.2}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"forbes.com/get_person_net_worth","input":{"name":"Elon Musk"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "forbes.com/get_person_net_worth" , "input": { "name": "Elon Musk" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "forbes.com/get_person_net_worth" , "input": { "name": "Elon Musk" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run forbes.com/get_person_net_worth# with {"name":"Elon Musk"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string", "examples": [ "Elon Musk" ], "description": "The billionaire's name, for example Elon Musk." } }}Output schema
{ "type": "object", "required": [ "name", "net_worth_billions_usd", "rank", "todays_change_billions_usd", "todays_change_percent", "source_of_wealth", "self_made_score", "self_made_label", "citizenship", "residence", "age", "photo_url", "profile_url", "updated_at" ], "properties": { "age": { "type": [ "integer", "null" ], "description": "Age in years." }, "name": { "type": [ "string", "null" ], "description": "The person's name, such as Elon Musk." }, "rank": { "type": [ "integer", "null" ], "description": "Rank on Forbes real-time billionaires list." }, "photo_url": { "type": [ "string", "null" ], "description": "Link to the profile photo." }, "residence": { "type": [ "string", "null" ], "description": "Residence shown on the Forbes profile." }, "updated_at": { "type": [ "string", "null" ], "description": "When Forbes updated the real-time ranking, in ISO 8601 Eastern time." }, "citizenship": { "type": [ "string", "null" ], "description": "Country of citizenship." }, "profile_url": { "type": [ "string", "null" ], "description": "Link to the Forbes profile." }, "self_made_label": { "type": [ "string", "null" ], "description": "Description of the self-made score from Forbes." }, "self_made_score": { "type": [ "integer", "null" ], "description": "Forbes self-made score from 1 to 10." }, "source_of_wealth": { "type": [ "string", "null" ], "description": "Wealth sources shown on the Forbes profile." }, "todays_change_percent": { "type": [ "number", "null" ], "description": "Percentage change since the prior trading day; negative means a loss." }, "net_worth_billions_usd": { "type": [ "number", "null" ], "description": "Real-time net worth in billions of US dollars." }, "todays_change_billions_usd": { "type": [ "number", "null" ], "description": "Change since the prior trading day in billions of US dollars; negative means a loss." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
forbes.com/get_person_net_worth- Returns
- name, net worth, rank, today's change, source of wealth, self-made score, citizenship, residence, age, photo, profile link, update time
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method forbes.com/get_person_net_worth with the inputs above.
Ask your agent
- What's Jensen Huang's net worth right now and how much has it moved today?
- Pull up Forbes' real-time profile for Bernard Arnault — rank, net worth, and where he lives
- How rich is Mukesh Ambani at the moment, and where does he rank among the world's wealthiest?
- Check the Forbes billionaires list for Françoise Bettencourt Meyers: current fortune, age, citizenship, and self-made score
- Is Larry Ellison up or down today? I need his live wealth figure and source of wealth.
See more
All Forbes methodsLists the richest people in rank order from Forbes Real-Time Billionaires, with net worth, daily change and profile details. Filter by country of citizenship or industry; wealth and changes are in billions of US dollars.
forbes.com/list_billionairesFinds a Forbes company profile by name and returns its Forbes list rankings, company facts and headline financial figures (Forbes list years; market value from the matching Global 2000 list).
forbes.com/get_company_rankingsLists companies in the Forbes Global 2000 in rank order, optionally for a given year, country of headquarters and industry. Financial figures are in billions of US dollars; up to 500 results.
forbes.com/list_global_2000Gets a company's Fortune 500 or Fortune 1000 rank and headline figures for a list year. CEO, ticker and website come from the current company profile and may not reflect a historical year.
fortune.com/get_company_rankGets the current quoted price and key figures for a stock, fund, index, or cryptocurrency on Google Finance, by name or ticker. Prices may be delayed, and figures Google does not show are null.
google.com/get_quoteGets a stock's latest MSN Money quote and key facts by company name or ticker and listing country. Quotes may be delayed outside market hours.
msn.com/get_stock_quoteLists the Fortune 500 for a year. You can filter by industry or sector and by headquarters state. Each company comes with its public financial and company details.
fortune.com/list_fortune_500Looks up a stock, fund, index, or cryptocurrency by name or ticker and returns its latest displayed price and key statistics. Unavailable figures are null; quotes may be delayed.
finance.yahoo.com/get_quote