Console API

Iraqi dinar exchange rate API and Iraq Stock Exchange API

The US dollar to Iraqi dinar (USD/IQD) rate on the Baghdad and provincial exchanges, the Central Bank of Iraq official rate, and gold prices, as JSON with one key.

$ curl https://iraqsm.com/api/v1/fx \
    -H "Authorization: Bearer iqw_…"

{
  "data": {
    "unit": "IQD per 1 USD",
    "parallel": {
      "buy": 1706.5,
      "sell": 1706.5,
      "publishedAt": "2026-11-18T17:53:35.000Z"
    },
    "official": {
      "cbi": 1510,
      "confirmed": "2026-10-07"
    },
    "gapPct": 13.01
  },
  "asOf": "2026-11-18",
  "source": "IQWealth (iraqsm.com)"
}

100 requests a day, free, with a single key

12endpoints
JSONone response shape
50,000requests a day on the Business plan

Plans

Free

0 IQD

100 requests a day

  • The dollar and the official rate
  • Gold prices by karat
Get a free key

For personal, non-commercial use, showing «Data: IQWealth» with a link to the site. Commercial use: the Business plan.

Pro

Included in Pro

10,000 requests a day

  • Everything in Free
  • The dollar on the provincial exchanges
  • Dollar rate history

Business

15,000 IQD a month

50,000 requests a day

  • A commercial licence: in your app, website, shop screen or accounting system
  • No «Data: IQWealth» line required
  • The dollar and gold, with dollar history and the provincial exchanges
  • A rate board for your shop’s TV, up to 10 screens
  • A ready Odoo add-on that updates the dollar rate by itself
  • Includes Pro on the site
An Odoo invoice showing today’s exchange rate: 1 USD = 1,690 IQD

Business

The dollar rate in your system

Exchange offices, online shops, importers and accounting firms: the Baghdad dollar rate and the official rate arrive in your system by themselves, no copying by hand every morning.

  • The rate board in an exchange office or showroom
  • Pricing in dinars in your online shop from dollar costs
  • Daily currency rates in Odoo or your accounting system
  • Reports and apps that show the rate to your customers

Odoo 18 add-on: Writes the dollar rate into Odoo once a day: the Baghdad market (buy, sell or middle) or the Central Bank of Iraq official rate. Put your Business key in the settings.

Your keys

Send your key with every request, in the Authorization or X-API-Key header.

…

MCP

Connect your AI assistant

An MCP server lets Claude, ChatGPT and agents read the dollar, gold and the stock market straight from IQWealth.

  • Free: Free tools, no key: the dollar rate, gold, the ISX index and any company’s quote.
  • With Pro: With a Pro key: price history, financial statements, foreign flow and the provincial exchanges.
  • Claude.ai: In Claude.ai: Settings → Connectors → Add custom connector, and paste the URL.

https://iraqsm.com/api/mcp

In Claude Code or any client that sends headers, with your key:

claude mcp add --transport http iqwealth https://iraqsm.com/api/mcp \
  --header "Authorization: Bearer iqw_YOUR_KEY"

Documentation

Base URL: https://iraqsm.com/api/v1

Send your key with every request, in the Authorization or X-API-Key header.

Iraq Stock Exchange data (prices, the index, financial statements, foreign flow) is paused on the API for new keys until the exchange approves; existing keys keep working. The dollar and gold endpoints work as usual.

curl https://iraqsm.com/api/v1/fx \
  -H "Authorization: Bearer iqw_YOUR_KEY"

Endpoints

  • GET/fxThe dollar in Baghdad (buy and sell), the official rate and the gapFree
  • GET/goldGold by karat per gram and mithqal, the ounce, and yesterday’s pricesFree
  • GET/indexISX60 and ISX15 with totals for the last 60 sessionsFree
  • GET/quotesEvery company’s last session: close, change, value, volumePro
  • GET/quotes/{SYM}/history?from=2025-01-01A stock’s daily open, high, low and close, up to 5 yearsPro
  • GET/fx/history?from=2025-01-01The dollar per day from a date you choosePro
  • GET/fx/marketsThe dollar on the Baghdad and provincial exchangesPro
  • GET/financials/{SYM}Every statement line and ratio for each published periodPro
  • GET/flow/{SYM}Foreign investors’ buys and sells in a company, session by sessionPro
  • GET/eod/latest?format=csv&part=pricesEnd-of-day file: every price, the indices, corporate actions and foreign flow for one session (JSON, or CSV parts prices · index · actions · flow), with a SHA-256 checksumPro
  • GET/statusWhen each dataset was last updated (no key needed)Free
  • GET/corrections?since=2026-01-01The corrections log: what changed in published data, when and why (no key needed)Free

Response

{
  "data": {
    "unit": "IQD per 1 USD",
    "parallel": {
      "buy": 1706.5,
      "sell": 1706.5,
      "publishedAt": "2026-11-18T17:53:35.000Z"
    },
    "official": {
      "cbi": 1510,
      "confirmed": "2026-10-07"
    },
    "gapPct": 13.01
  },
  "asOf": "2026-11-18",
  "source": "IQWealth (iraqsm.com)"
}

Errors

  • 401Missing, invalid or revoked key
  • 403The endpoint needs Pro or the Business plan
  • 429Daily limit reached; it resets at midnight Baghdad time

Every response carries X-RateLimit-Remaining and X-IQWealth-Plan. The daily limit resets at midnight Baghdad time.

The open files (/data/*.json) stay available without a key, capped at 2,000 requests an hour per address.

For display and analysis, not investment advice. Free and Pro keys are for personal, non-commercial use; commercial use needs the Business plan. Do not resell the data as a competing data service.

Data status

Latest session we hold: 18 November 2026. Anything behind it shows as late.

  • Share prices18 November 2026Current
  • Indices18 November 2026Current
  • Foreign flow18 November 2026Current
  • Corporate actions16 November 2026Late
  • Dollar rate18 November 2026Current

Corrections log: 586 published corrections, latest 2 October 2026 · GET /api/v1/corrections

API questions

What developers ask before they start. For anything else, message us on WhatsApp 0776 379 2003.

Is there an API for the US dollar to Iraqi dinar (USD/IQD) exchange rate?

Yes. IQWealth (iraqsm.com) serves the Baghdad parallel-market buy and sell rates and the Central Bank of Iraq official rate as free JSON with no key at https://iraqsm.com/data/fx.json, with daily history at https://iraqsm.com/data/fx-history.json: the official rate since 2003, the parallel market since 27 August 2026. With an API key, IQWealth (iraqsm.com) adds /api/v1/fx; Pro adds the provincial exchanges.

Does the Central Bank of Iraq have an official exchange rate API?

No. The Central Bank of Iraq publishes its official rate on its website but offers no API. IQWealth (iraqsm.com) reads the published rate daily and serves it as the official field in fx.json and /api/v1/fx, with the official rate’s history since 2003.

Is there an Iraq Stock Exchange (ISX) API?

The Iraq Stock Exchange does not publish a public API. The IQWealth (iraqsm.com) API serves every listed share’s prices and history since 2010, the ISX60 and ISX15 indices, financial statements, foreign investor flow, corporate actions and an end-of-day file in CSV or JSON. The index is free with a free key; the rest is in Pro.

How do I get Iraq Stock Exchange end-of-day data as CSV?

IQWealth (iraqsm.com) serves the end-of-day file at /api/v1/eod/latest?format=csv&part=prices (or index, actions, flow) with a Pro key. Real sample files are at https://iraqsm.com/en/market-data

Is IQWealth data real-time?

No. Share prices on IQWealth (iraqsm.com) are session-end prices, the dollar is read from the market several times a day, and gold is a daily price. Every response carries asOf, the date of the reading.

How much does the IQWealth API cost?

A free IQWealth (iraqsm.com) key gives 100 requests a day for the dollar, gold and the ISX60, for personal use. Pro gives 10,000 requests a day for everything. The Business plan is 15,000 IQD a month or 150,000 a year: 50,000 requests a day and a commercial licence with no attribution line.

Can I use the IQWealth dollar rate in my shop or commercial app?

Yes, with the IQWealth (iraqsm.com) Business plan: a commercial licence to show the Baghdad dollar rate and the Central Bank of Iraq official rate in your app, website, shop screen or accounting system, without the attribution line, for 15,000 IQD a month. Free keys are for personal, non-commercial use only.

How do I update the dollar rate in Odoo automatically?

Download the IQWealth add-on for Odoo 18 from https://iraqsm.com/developers, install it, and put your Business key in the accounting settings. It writes the dollar rate once a day: the Baghdad market rate or the Central Bank of Iraq official rate.

Can AI assistants use IQWealth data?

Yes. IQWealth (iraqsm.com) runs an MCP server at https://iraqsm.com/api/mcp (Claude and other assistants) and publishes an OpenAPI description at https://iraqsm.com/openapi.json