oanor
Sign up free
Marketplace Pricing Features Sign in

API · /irr-api

Iran Rial Market API

healthy 4,543 Subscribers

Live free-market (bazaar) prices for the Iranian rial against foreign currencies, gold and gold coins. Iran's official rate is fixed and unused in practice; the real economy trades on the open bazaar rate, which is what this API exposes. The price endpoint returns one instrument's latest close/open/high/low, day change and date — in both rial and toman. The currencies endpoint returns every foreign currency (USD, EUR, GBP, AED, TRY, CNY, RUB …) against the rial at once. The gold endpoint returns Iran's gold market — the global ounce, 18k and 24k gram, the mesghal, and the famous gold coins (Emami, Bahar Azadi, half, quarter, gerami). The history endpoint returns an instrument's daily OHLC series. Read live, nothing stored. This is Iran's own free-market rial/gold/coin layer — distinct from official central-bank feeds and from other countries' parallel-dollar APIs.

#iran #rial #irr #forex #gold #bazaar #free-market #currency
api.oanor.com/irr-api
Get an API key Try in playground → Contact provider

Machine-readable spec so AI agents can integrate this API.

/api/irr-api/openapi.json
/api/irr-api/llms.txt

Discovery: GET /api/index.json lists every API.

Iran Rial Market API — live data on the oanor API marketplace

API health

healthy
Uptime
100.00%
Server probes · 24h
Avg latency
2381 ms
Server probes · 24h
Subscribers
4,543
active
Total calls
120
last 7 days
status Full status page → · 24 probes/24h

Pricing

Pick a tier — billed monthly, cancel anytime.

Free

Free

  • 2,000 calls / month
  • 2 requests / second
  • Hard cap (429 above quota, no overage)
  • 2k calls/month
  • 2 req/sec
  • All endpoints
  • No credit card
Sign in to subscribe

Starter

€7.00 /month

  • 60,000 calls / month
  • 12 requests / second
  • Hard cap (429 above quota, no overage)
  • 60k calls/month
  • 12 req/sec
  • Email support
Sign in to subscribe

Pro

€22.00 /month

  • 300,000 calls / month
  • 35 requests / second
  • Hard cap (429 above quota, no overage)
  • 300k calls/month
  • 35 req/sec
  • Priority support
Sign in to subscribe

Scale

€52.00 /month

  • 2,000,000 calls / month
  • 110 requests / second
  • Hard cap (429 above quota, no overage)
  • 2M calls/month
  • 110 req/sec
  • Dedicated SLA
Sign in to subscribe

Built by

P
PremiumApi

Related APIs

Other APIs with overlapping tags.

NPV & IRR API — oanor API marketplace

NPV & IRR API

Discounted-cash-flow investment-appraisal maths as an API, computed locally and deterministically. The npv endpoint computes the net present value of a project from an upfront outlay, a series of future net cash flows and a discount rate, NPV = −initial + Σ CFₜ/(1+r)ᵗ, and reports the present value of the inflows, the profitability index and a plain accept-or-reject decision. The irr endpoint solves the internal rate of return — the discount rate that makes the NPV zero — by robust bisection over the cash flows, the figure you compare against a hurdle rate. The payback endpoint computes both the simple payback period, when the cumulative cash flow first recovers the outlay, and the discounted payback period, which discounts each flow first. Cash flows are passed as a comma-separated list, one per period. Everything is computed locally and deterministically, so it is instant and private. Ideal for finance, corporate, fintech and project-management app developers, capital-budgeting and feasibility tools, and finance education. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is capital budgeting; for loan amortization use a loan API and for CAGR and real returns an investment API.

api.oanor.com/npv-api

 Investment Calculator API — oanor API marketplace

Investment Calculator API

Investment and capital-budgeting maths as an API. The npv endpoint computes the net present value of a series of cash flows at a discount rate (the first flow is usually the negative initial investment). The irr endpoint finds the internal rate of return — the discount rate at which the net present value is zero — by a robust bracketed search. The annuity endpoint solves a level (ordinary) annuity: give the rate, the number of periods and any one of the payment, present value or future value, and it returns the other two. The depreciation endpoint builds a full year-by-year schedule by the straight-line, declining-balance (any factor, including double-declining) or sum-of-the-years'-digits method, never depreciating below the salvage value. Rates may be entered as a percentage or a fraction. Everything is computed locally and deterministically, so it is instant and private. Ideal for investment analysis and capital budgeting, accounting and corporate-finance tools, business planning, and finance education. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 5 endpoints. This is investment and capital-budgeting maths; for loans, mortgages and compound interest use a financial-calculator API.

api.oanor.com/financecalc-api

 Mongolia Statistics API — oanor API marketplace

Mongolia Statistics API

Official Mongolian inflation statistics straight from the National Statistics Office of Mongolia (NSO) via its 1212.mn PxWeb open-data service — no key, read live. The cpi endpoint returns the headline national Consumer Price Index (Overall index, base 2023=100) for the latest month with the index level plus month-on-month and year-on-year inflation, computed from the official series. The cpi/series endpoint returns the historical monthly CPI index and year-on-year rate over the last N months, ready to chart. The cpi/groups endpoint breaks the latest CPI down across all thirteen COICOP groups (food, housing, transport and so on) with index and annual change for each. The cpi/annual endpoint gives the annual-average CPI and average inflation for every year on record. The meta endpoint documents the source. Live data from Mongolia NSO PxWeb, lightly cached. Live. 5 endpoints. This serves Mongolian national price statistics; for the tugrik exchange rate use an FX / central-bank API.

api.oanor.com/mongolia-stats-api

 North Macedonia Statistics API — oanor API marketplace

North Macedonia Statistics API

Official North Macedonian inflation statistics straight from the State Statistical Office (MAKStat) via its ASKdata-style PxWeb open-data service — no key, read live. The cpi endpoint returns the headline Consumer Price Index inflation for the latest month — the month-on-month and year-on-year percentage changes (ECOICOP version 2 classification) — derived from the official ratio table. The cpi/series endpoint returns the historical monthly MoM and YoY series over the last N months, ready to chart. The cpi/groups endpoint breaks the latest year-on-year inflation down across all thirteen COICOP main groups (food, housing, transport and so on). The cpi/group endpoint returns the full MoM and YoY history for any single COICOP group by its code. The meta endpoint documents the COICOP group codes and source. Live data from MAKStat PxWeb, lightly cached. Live. 5 endpoints. This serves North Macedonian national price statistics; for the denar exchange rate use an FX / central-bank API.

api.oanor.com/macedonia-stats-api

Frequently asked questions

Quick answers about pricing, quotas, and integration.

How do I get an API key for Iran Rial Market API?
Sign up for free at oanor.com, generate an API key from the developer dashboard, and call Iran Rial Market API with the x-oanor-key header. No credit card needed for the free tier.
What's the rate limit for Iran Rial Market API?
Free tier allows 1 request per second. Paid plans scale up to 50 requests per second on the Mega tier. Hard limits return HTTP 429 above the quota — no surprise overage charges.
How much does Iran Rial Market API cost?
Iran Rial Market API has a free tier with 100 calls / month. Paid plans start at €7.00 / month with higher quotas and faster rate limits.
Can I cancel my subscription anytime?
Yes. Plans are billed monthly and you can cancel anytime from your billing dashboard. No long-term contracts and no cancellation fee.
Is Iran Rial Market API GDPR-compliant?
All requests to Iran Rial Market API go through our EU-based gateway. Your upstream API key never leaves our server and no personal data is shared with the upstream provider beyond the request you send.

Pick an endpoint from the list on the left to see its details and try it.

Code snippets

Sign up to get an API key, then call any path under your slug.

curl https://api.oanor.com/irr-api/SOME_PATH \
  -H "x-oanor-key: oanor_test_..."
const res = await fetch("https://api.oanor.com/irr-api/SOME_PATH", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
const data = await res.json();
$ch = curl_init("https://api.oanor.com/irr-api/SOME_PATH");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
$response = curl_exec($ch);
import requests
r = requests.get(
    "https://api.oanor.com/irr-api/SOME_PATH",
    headers={"x-oanor-key": "oanor_test_..."},
)
print(r.json())

Ratings

Sign in to rate.

No reviews yet.

Discussion

Ask questions, share usage tips, get answers from the provider and other developers. Public — anyone can read.

Sign in to start a thread or reply.

Sign in

New thread

/ 4000

📌 Pinned 🔒 Locked

·

· ·

/ 4000

🔒 This thread is locked — no new replies.

  • No threads yet — start the discussion.

Support

Private 1:1 support with the provider — billing questions, integration issues, account problems. Only you and the provider team can see these threads.

Sign in to open a support ticket.

Sign in

Open new ticket

Describe what you need help with. The provider team gets an email and replies on the ticket page.

  • No tickets yet for this API.

Subscription active — calls can start immediately.

Send your first request —

Subscription active — copy a snippet and fire off your first call.