Comparison

Full Comparison Of Two Wealths

Given an expression, two wealths (yours and theirs), and that expression's own parameters, returns the expression's result for both wealths plus the ratio between them — a complete "them vs. you" comparison in a single call.

get/comparison

Request

Base URL: https://api.wegtultrarich.org/v1
URL: https://api.wegtultrarich.org/v1/comparison
Auth: none required

Query parameters

expression'durationOfDailySpend' | 'heightOfMoneyStack' | 'numberOfItems' | 'growthOfCompoundInterest' required

Expression is the wealth expression to compute for both wealths (the crux of this comparison): * durationOfDailySpend - also requires spend * heightOfMoneyStack - also requires typeOfMoney * numberOfItems - also requires typeOfItem (see note above about use of approximate U.S. benchmark prices denominated in USD) * growthOfCompoundInterest - also requires rate, frequency, and period

number required

a numeric amount with or without decimal places

string required

a string with a local-formatted number (like 1,000,000) or shorthand (like 1M) with or without a URL-encoded currency symbol

Example:1000000000

Wealth Yours is the amount of money of the user ("your" wealth) to be compared via the specified expression.

number required

a numeric amount with or without decimal places

string required

a string with a local-formatted number (like 1,000,000) or shorthand (like 1M) with or without a URL-encoded currency symbol

Example:1000000000

Wealth Theirs is the amount of money of the ultrarich ("their" wealth) to be compared via the specified expression.

number

a numeric amount with or without decimal places

string

a string with a local-formatted number (like 1,000,000) or shorthand (like 1M) with or without a URL-encoded currency symbol

Example:1000

Spend is the amount of money to be spent daily. Required when expression is durationOfDailySpend; ignored otherwise.

Type Of Money is the money to be stacked. Required when expression is heightOfMoneyStack; ignored otherwise. * usd_1_coin - Dollar Coins (USD; 2 mm per coin); * usd_100_bill - Hundred-Dollar Bills (USD; 0.11 mm per bill); * cad_1_coin - Loonies (CAD; 1.95 mm per coin); * cad_100_bill - Hundred-Dollar Bills (CAD; 0.0875 mm per bill); * eur_1_coin - Euro Coins (EUR; 2.33 mm per coin); * eur_100_bill - Hundred-Euro Bills (EUR; 0.12 mm per bill); * gbp_1_coin - Pound Coins (GBP; 2.8 mm per coin); * gbp_100_bill - Hundred-Pound Bills (GBP; 0.0825 mm per bill); * cny_1_coin - Yuan Coins (CNY; 1.85 mm per coin); * cny_100_bill - Hundred-Yuan Bills (CNY; 0.1 mm per bill); * inr_1_coin - Rupee Coins (INR; 1.45 mm per coin); * inr_100_bill - Hundred-Rupee Bills (INR; 0.11 mm per bill); * krw_1_coin - Won Coins (KRW; 1.45 mm per coin); * krw_1000_bill - Thousand-Won Bills (KRW; 0.1 mm per bill); * rub_1_coin - Ruble Coins (RUB; 1.5 mm per coin); * rub_100_bill - Hundred-Ruble Bills (RUB; 0.1 mm per bill); * try_1_coin - Lira Coins (TRY; 2 mm per coin); * try_100_bill - Hundred-Lira Bills (TRY; 0.105 mm per bill); * chf_1_coin - Franc Coins (CHF; 1.55 mm per coin); * chf_100_bill - Hundred-Franc Bills (CHF; 0.11 mm per bill); * brl_1_coin - Real Coins (BRL; 1.95 mm per coin); or * brl_100_bill - Hundred-Real Bills (BRL; 0.105 mm per bill).

Type Of Item is the item to be bought or paid for/off. Required when expression is numberOfItems; ignored otherwise. * fancy_coffee - $10 Fancy Coffee * quick_meal - $15 Quick Meal * dinner_with_drinks - $175 Dinner With Drinks * iphone - $1,400 iPhone * month_of_childcare - $1,750 Month Of Childcare * rent_or_mortgage_payment - $3,000 Rent Or Mortgage Payment * year_of_low_minimum_wage_salary - Year Of Low Minimum Wage Salary ($15,080) * year_of_high_minimum_wage_salary - Year Of High Minimum Wage Salary ($32,240) * student_loan_debt - $40K Student Loan Debt * car - $50K Car * year_of_salary_65k - Year Of $65,000 Salary * year_of_salary_100k - Year Of $100,000 Salary * luxury_car - $275K Luxury Car * house - $500K House * yacht - $800K Yacht * supercar - $4M Supercar * island - $30M Island * mansion - $75M Mansion * estate_with_a_mega_mansion - $200M Estate With A Mega-Mansion * luxury_island - $300M Luxury Island * superyacht - $600M Superyacht

ratenumber float

Example:0.01

Rate is the interest rate at which the wealths are compounded. Required when expression is growthOfCompoundInterest; ignored otherwise.

frequency'1' | '2' | '4' | '12' | '365'

Frequency is how often the wealths are compounded (1 Annually; 2 Semiannually; 4 Quarterly; 12 Monthly; 365 Daily). Required when expression is growthOfCompoundInterest; ignored otherwise.

periodnumber

Example:20

Period is the duration of time in years over which the wealths are compounded. Required when expression is growthOfCompoundInterest; ignored otherwise.

Response

a JSON object with response data

statusstring required

Example response

{
  "status": "success",
  "data": {
    "expression": "durationOfDailySpend",
    "resultTheirs": {
      "value": 273972.602739726,
      "unit": "years",
      "phrase": "274 Millennia (273,973 Years)",
      "sentence": "A person with a wealth of $100,000,000,000 could spend $1,000 every day for 274 millennia (273,973 years)!",
      "scale": "That's approximately 1.6 times as long ago as when Homo Sapiens began wearing primitive clothing (≈170K BCE)."
    },
    "resultYours": {
      "value": 0.273972602739726,
      "unit": "years",
      "phrase": "100 Days",
      "sentence": "A person with a wealth of $100,000 could spend $1,000 every day for 100 days!"
    },
    "ratio": {
      "value": 1000000,
      "phrase": "1,000,000 : 1",
      "sentence": "Their wealth is 1,000,000 times yours.",
      "scale": "That's extreme wealth inequality."
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.