Catalog / Bonbast Live EUR and USD to IRR Rates

Bonbast Live EUR and USD to IRR Rates API

bonbast.com

Read-only live free-market dealer quotes from Bonbast for USD and EUR. The source returns both pairs together from one anonymous homepage-token and same-session JSON request. Bonbast displays its quote numbers in Iranian Toman; this API preserves those source values and converts them to Iranian Rials using 1 Toman = 10 Rials. sell_irr is the dealer sell quote and buy_irr is the dealer buy quote. last_modified is the source update time at minute precision; retrieved_at is this API's retrieval time. The deprecated currency compatibility parameter does not filter the paired source response.

  • Finance
  • exchange rates
  • Iranian rial
  • Toman
  • USD
  • EUR
1 endpointDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the Bonbast Live EUR and USD to IRR Rates API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

Fetch a fresh Bonbast homepage token and paired current rates. The caller never supplies or stores the short-lived source token. The service obtains it over HTTP and uses it only in the same anonymous curl_cffi session for the source's public JSON read.

Optional parameters 1

Deprecated compatibility hint retained from the previous API. It is accepted but does not filter the response; both USD and EUR are always returned. Omit it for the current unfiltered operation.

View call pricing
cURL · Exchange rates
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/6f9203b6-f95e-456d-9981-6c8af962e857/v1/exchange-rates' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY"

Endpoints

Inputs and response fields for every endpoint in this API.

GETExchange rates/v1/exchange-rates

Fetch a fresh Bonbast homepage token and paired current rates. The caller never supplies or stores the short-lived source token. The service obtains it over HTTP and uses it only in the same anonymous curl_cffi session for the source's public JSON read.

Input

currencyOptionalQuery · string | null

Deprecated compatibility hint retained from the previous API. It is accepted but does not filter the response; both USD and EUR are always returned. Omit it for the current unfiltered operation.

Example: usd

Response

eurobject
eur.buy_irrinteger
eur.currency"USD" | "EUR"
eur.sell_irrinteger
eur.rate_unitstring
eur.quote_currencystring
eur.source_buy_tomaninteger
eur.source_rate_unitstring
eur.source_sell_tomaninteger
usdobject
usd.buy_irrinteger
usd.currency"USD" | "EUR"
usd.sell_irrinteger
usd.rate_unitstring
usd.quote_currencystring
usd.source_buy_tomaninteger
usd.source_rate_unitstring
usd.source_sell_tomaninteger
transportstring
source_urlstring
retrieved_atstring (date-time)
last_modifiedstring
source_timestamp_meaningstring
source_timestamp_timezonestring
source_timestamp_precisionstring

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.