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.

API health

healthy
Uptime
100.00%
Server probes · 24h
Avg latency
2732 ms
Server probes · 24h
Subscribers
4,543
active
Total calls
12
last 7 days
status Full status page → · 18 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

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

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

Currency Converter API

Live foreign-exchange conversion across 160+ world currencies — the plain, developer-friendly converter. Get the latest rates for any base currency, convert an amount between any two currencies, read the rate (and inverse) for a single pair, or list every supported currency. Rates are read live from an open exchange-rate source that aggregates a broad set of feeds and covers far more currencies than ECB-only data — including emerging-market and exotic currencies such as the Nigerian naira, Indian rupee or Vietnamese dong. This is the everyday convert / latest-rates utility a checkout, invoice, pricing page or travel app needs — distinct from the FX analytics APIs in the catalogue (historical date ranges, pip and position-size calculators, triangular-arbitrage path maths, currency indices), which compute on rates rather than simply converting them.

api.oanor.com/currencyconverter-api

NBKR Kyrgyzstan FX API

Live official foreign-exchange reference rates from the National Bank of the Kyrgyz Republic (NBKR), read straight from the bank's published fixing — no key on the data, nothing cached, nothing stored. Get every currency the NBKR fixes against the Kyrgyzstani som (KGS) for the day, each normalized to a clean per-unit rate; look one currency up on its own; pull the separate weekly accounting rates (valid for seven days); or convert any amount between two listed currencies by crossing through the som. The som is the base and rates carry the NBKR fixing date. This is the Kyrgyzstan national-central-bank feed specifically — a distinct official source, separate from the other FX, central-bank and market APIs in the catalogue, so treasury, invoicing, payroll and accounting workflows that need the legally-referenced KGS rate can read it directly.

api.oanor.com/nbkr-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.