Mehr Rates | Real-time Multi-Provider Currency & Crypto Feed

Unified Rate Sheet

Consolidated real-time rates across all 11 first-party data providers in a single compact schema.

Returns the full market state including free-market currencies (USD, EUR, AED in Tomans), sovereign gold coins (Emami, Azadi), bullion benchmarks (18K gold, Mithqal, Ounce), global fiat cross-rates, and major crypto tickers.

GET/latest

curl -sS -H "Accept: application/json" "https://rates-api.mehrnet.com/latest"

const response = await fetch("https://rates-api.mehrnet.com/latest", {
  headers: { "Accept": "application/json" }
});
const data = await response.json();

$opts = ["http" => ["header" => "Accept: application/json\r\n"]];
$ctx = stream_context_create($opts);
$json = file_get_contents("https://rates-api.mehrnet.com/latest", false, $ctx);
$data = json_decode($json, true);

from urllib.request import Request, urlopen
import json

req = Request("https://rates-api.mehrnet.com/latest", headers={"Accept": "application/json"})
data = json.load(urlopen(req))

req, _ := http.NewRequest("GET", "https://rates-api.mehrnet.com/latest", nil)
req.Header.Set("Accept", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer resp.Body.Close()

var data map[string]any
json.NewDecoder(resp.Body).Decode(&data)

200 OK

{
  "timestamp": 1786712702228,
  "date_iso": "2026-08-14T13:05:02.228Z",
  "base": "IRT",
  "currencies": {
    "USD": { "buy": 186192, "sell": 187300 },
    "EUR": { "buy": 215418, "sell": 216700 },
    "AED": { "buy": 50897, "sell": 51200 }
  },
  "coins": {
    "EMAMI": { "buy": 186500000, "sell": 189500000 },
    "AZADI": { "buy": 182000000, "sell": 186000000 }
  },
  "gold": {
    "GOLD_GRAM_18K": 19038275,
    "MITHQAL": 82470000,
    "OUNCE": 4374.9
  },
  "fiat": {
    "base": "USD",
    "rates": { "EUR": 0.921, "GBP": 0.792, "IRT": 187300 }
  },
  "crypto": {
    "base": "USD",
    "rates": { "BTC": 62787.52, "ETH": 3415.2, "SOL": 182.4 }
  },
  "sources": [
    { "id": "hub_arzbin", "age_seconds": 5 },
    { "id": "bonbast", "age_seconds": 4 }
  ]
}

Targeted Query Filter

Filter the payload by specific symbols or entire asset categories to reduce transfer size to ~0.8 KB.

Ideal for bandwidth-sensitive clients, widgets, and bots that only need specific rates without fetching the full market directory.

GET/latest?symbols={list}&category={type}

Parameters

Parameter	In	Required	Description
`symbols`	Query	No	Comma-separated symbols (e.g. `USD,EUR,BTC,ETH,EMAMI,GOLD_18K`).
`category`	Query	No	Filter category: `market`, `coins`, `gold`, `fiat`, or `crypto`.
`limit_crypto`	Query	No	Limit crypto dictionary to top N major tokens (e.g. `50`).

curl -sS -H "Accept: application/json" "https://rates-api.mehrnet.com/latest?symbols=USD,EUR,BTC,ETH,EMAMI,GOLD_18K"

const res = await fetch("https://rates-api.mehrnet.com/latest?symbols=USD,EUR,BTC,ETH,EMAMI,GOLD_18K", {
  headers: { "Accept": "application/json" }
});
const data = await res.json();

$opts = ["http" => ["header" => "Accept: application/json\r\n"]];
$ctx = stream_context_create($opts);
$data = json_decode(file_get_contents("https://rates-api.mehrnet.com/latest?symbols=USD,EUR,BTC,ETH,EMAMI,GOLD_18K", false, $ctx), true);

from urllib.request import Request, urlopen
import json

req = Request("https://rates-api.mehrnet.com/latest?symbols=USD,EUR,BTC,ETH,EMAMI,GOLD_18K", headers={"Accept": "application/json"})
data = json.load(urlopen(req))

req, _ := http.NewRequest("GET", "https://rates-api.mehrnet.com/latest?symbols=USD,EUR,BTC,ETH,EMAMI,GOLD_18K", nil)
req.Header.Set("Accept", "application/json")
resp, _ := http.DefaultClient.Do(req)
var data map[string]any
json.NewDecoder(resp.Body).Decode(&data)

const res = await fetch("https://rates-api.mehrnet.com/latest?symbols=USD,EUR,BTC,ETH,EMAMI,GOLD_18K");
const data = await res.json();

$data = json_decode(file_get_contents("https://rates-api.mehrnet.com/latest?symbols=USD,EUR,BTC,ETH,EMAMI,GOLD_18K"), true);

from urllib.request import urlopen
import json

data = json.load(urlopen("https://rates-api.mehrnet.com/latest?symbols=USD,EUR,BTC,ETH,EMAMI,GOLD_18K"))

resp, _ := http.Get("https://rates-api.mehrnet.com/latest?symbols=USD,EUR,BTC,ETH,EMAMI,GOLD_18K")
var data map[string]any
json.NewDecoder(resp.Body).Decode(&data)

200 OK (0.8 KB)

{
  "timestamp": 1786712702228,
  "date_iso": "2026-08-14T13:05:02.228Z",
  "base": "IRT",
  "currencies": {
    "USD": { "buy": 186192, "sell": 187300 },
    "EUR": { "buy": 215418, "sell": 216700 }
  },
  "coins": {
    "EMAMI": { "buy": 186500000, "sell": 189500000 }
  },
  "crypto": {
    "base": "USD",
    "rates": { "BTC": 62787.52, "ETH": 3415.2 }
  },
  "sources": [ ... ]
}

Single Asset Rate

Lookup real-time valuation, buy/sell spreads, and Toman conversions for any specific asset symbol.

Supports fiat currencies (e.g. usd, eur, aed, irt), cryptocurrencies (e.g. btc, eth, sol), and gold/coins (e.g. emami, azadi, gold_18k).

GET/rate/{symbol}

Parameters

Parameter	In	Required	Description
`symbol`	Path	Yes	Asset ticker symbol (case-insensitive, e.g. `usd`, `btc`, `emami`).

curl -sS -H "Accept: application/json" "https://rates-api.mehrnet.com/rate/usd"

const res = await fetch("https://rates-api.mehrnet.com/rate/usd", {
  headers: { "Accept": "application/json" }
});
const data = await res.json();

$opts = ["http" => ["header" => "Accept: application/json\r\n"]];
$ctx = stream_context_create($opts);
$data = json_decode(file_get_contents("https://rates-api.mehrnet.com/rate/usd", false, $ctx), true);

from urllib.request import Request, urlopen
import json

req = Request("https://rates-api.mehrnet.com/rate/usd", headers={"Accept": "application/json"})
data = json.load(urlopen(req))

req, _ := http.NewRequest("GET", "https://rates-api.mehrnet.com/rate/usd", nil)
req.Header.Set("Accept", "application/json")
resp, _ := http.DefaultClient.Do(req)
var data map[string]any
json.NewDecoder(resp.Body).Decode(&data)

200 OK

{
  "symbol": "USD",
  "category": "market",
  "sell": 187300,
  "buy": 186192,
  "base": "IRT",
  "timestamp": 1786712702228,
  "date_iso": "2026-08-14T13:05:02.228Z"
}

Cross-Pair Conversion

Convert value dynamically between any two global currencies, cryptocurrencies, or Tomans.

Computes direct exchange rates, inverse rates, and total converted amounts across arbitrary cross pairs (e.g. EUR/USD, BTC/EUR, USD/IRT, AED/TRY).

GET/rate?pair={from}/{to}&amount={n}

Parameters

Parameter	In	Required	Description
`pair`	Query	Yes	Cross pair in `BASE/TARGET` format (e.g. `EUR/USD`, `USD/IRT`).
`amount`	Query	No	Numeric amount to convert (default: `1`).

curl -sS -H "Accept: application/json" "https://rates-api.mehrnet.com/rate?pair=EUR/USD&amount=100"

const res = await fetch("https://rates-api.mehrnet.com/rate?pair=EUR/USD&amount=100", {
  headers: { "Accept": "application/json" }
});
const data = await res.json();

$opts = ["http" => ["header" => "Accept: application/json\r\n"]];
$ctx = stream_context_create($opts);
$data = json_decode(file_get_contents("https://rates-api.mehrnet.com/rate?pair=EUR/USD&amount=100", false, $ctx), true);

from urllib.request import Request, urlopen
import json

req = Request("https://rates-api.mehrnet.com/rate?pair=EUR/USD&amount=100", headers={"Accept": "application/json"})
data = json.load(urlopen(req))

req, _ := http.NewRequest("GET", "https://rates-api.mehrnet.com/rate?pair=EUR/USD&amount=100", nil)
req.Header.Set("Accept", "application/json")
resp, _ := http.DefaultClient.Do(req)
var data map[string]any
json.NewDecoder(resp.Body).Decode(&data)

200 OK

{
  "pair": "EUR/USD",
  "base": "EUR",
  "target": "USD",
  "rate": 1.157,
  "inverse_rate": 0.864,
  "amount": 100,
  "converted_value": 115.7,
  "timestamp": 1786712702228,
  "date_iso": "2026-08-14T13:05:02.228Z"
}

Providers Registry

Inspect fleet health, polling cadences, and last sync timestamps across all active providers.

Provides deep visibility into first-party scraper operational statuses (Bonbast, Navasan, TGJU, Arzbin, Binance, Coinbase, Open ER, etc.).

GET/providers

curl -sS -H "Accept: application/json" "https://rates-api.mehrnet.com/providers"

const res = await fetch("https://rates-api.mehrnet.com/providers", {
  headers: { "Accept": "application/json" }
});
const data = await res.json();

$opts = ["http" => ["header" => "Accept: application/json\r\n"]];
$ctx = stream_context_create($opts);
$data = json_decode(file_get_contents("https://rates-api.mehrnet.com/providers", false, $ctx), true);

from urllib.request import Request, urlopen
import json

req = Request("https://rates-api.mehrnet.com/providers", headers={"Accept": "application/json"})
data = json.load(urlopen(req))

req, _ := http.NewRequest("GET", "https://rates-api.mehrnet.com/providers", nil)
req.Header.Set("Accept", "application/json")
resp, _ := http.DefaultClient.Do(req)
var data map[string]any
json.NewDecoder(resp.Body).Decode(&data)

200 OK

{
  "providers": [
    {
      "id": "bonbast",
      "label": "Bonbast Live Rates",
      "category": "iran_market",
      "last_status": "OK",
      "consecutive_errors": 0,
      "last_synced_ago_seconds": 6
    }
  ],
  "timestamp": 1786712702228
}

Telemetry Logs

Stream real-time scraper execution traces, network response times, and failover telemetry.

Provides audit logs for every scraper cycle with execution durations and residential proxy engagement records.

GET/logs?limit={n}&provider={id}

Parameters

Parameter	In	Required	Description
`limit`	Query	No	Number of log records to return (1-100, default: `50`).
`provider`	Query	No	Filter logs by specific provider ID (e.g. `bonbast`, `binance`).
`page`	Query	No	Pagination page index (default: `1`).

curl -sS -H "Accept: application/json" "https://rates-api.mehrnet.com/logs?limit=5"

const res = await fetch("https://rates-api.mehrnet.com/logs?limit=5", {
  headers: { "Accept": "application/json" }
});
const data = await res.json();

$opts = ["http" => ["header" => "Accept: application/json\r\n"]];
$ctx = stream_context_create($opts);
$data = json_decode(file_get_contents("https://rates-api.mehrnet.com/logs?limit=5", false, $ctx), true);

from urllib.request import Request, urlopen
import json

req = Request("https://rates-api.mehrnet.com/logs?limit=5", headers={"Accept": "application/json"})
data = json.load(urlopen(req))

req, _ := http.NewRequest("GET", "https://rates-api.mehrnet.com/logs?limit=5", nil)
req.Header.Set("Accept", "application/json")
resp, _ := http.DefaultClient.Do(req)
var data map[string]any
json.NewDecoder(resp.Body).Decode(&data)

200 OK

{
  "page": 1,
  "limit": 5,
  "total": 1420,
  "logs": [
    {
      "id": 2489,
      "provider_id": "bonbast",
      "level": "INFO",
      "message": "Scrape succeeded for Bonbast Live Rates",
      "details": { "duration_ms": 295, "used_emergency_proxy": false },
      "created_date": "2026-08-14T13:05:02.228Z"
    }
  ]
}

Health & Status

Check edge service uptime and SQLite Cloudflare D1 database operational state.

Heartbeat probe for load balancers, ping services, and uptime monitoring.

GET/health

curl -sS -H "Accept: application/json" "https://rates-api.mehrnet.com/health"

const res = await fetch("https://rates-api.mehrnet.com/health", {
  headers: { "Accept": "application/json" }
});
const data = await res.json();

$opts = ["http" => ["header" => "Accept: application/json\r\n"]];
$ctx = stream_context_create($opts);
$data = json_decode(file_get_contents("https://rates-api.mehrnet.com/health", false, $ctx), true);

from urllib.request import Request, urlopen
import json

req = Request("https://rates-api.mehrnet.com/health", headers={"Accept": "application/json"})
data = json.load(urlopen(req))

req, _ := http.NewRequest("GET", "https://rates-api.mehrnet.com/health", nil)
req.Header.Set("Accept", "application/json")
resp, _ := http.DefaultClient.Do(req)
var data map[string]any
json.NewDecoder(resp.Body).Decode(&data)

const res = await fetch("https://rates-api.mehrnet.com/health");
const data = await res.json();

$data = json_decode(file_get_contents("https://rates-api.mehrnet.com/health"), true);

from urllib.request import urlopen
import json

data = json.load(urlopen("https://rates-api.mehrnet.com/health"))

resp, _ := http.Get("https://rates-api.mehrnet.com/health")
var data map[string]any
json.NewDecoder(resp.Body).Decode(&data)

200 OK

{
  "status": "ok",
  "service": "rates-api",
  "uptime": true,
  "server_time": "2026-08-14T13:05:02.228Z"
}

Historical Rate Sheet

Retrieves the consolidated daily closing rate sheet for any past calendar date across all 1,970 assets.

Supports ?date=YYYY-MM-DD with optional ?symbols=USD,EUR,BTC and ?category=market filters.

GET/historical?date=2026-08-14&symbols=USD,EUR,BTC,EMAMI

curl -sS -H "Accept: application/json" "https://rates-api.mehrnet.com/historical?date=2026-08-14&symbols=USD,EUR,BTC,EMAMI"

const res = await fetch("https://rates-api.mehrnet.com/historical?date=2026-08-14&symbols=USD,EUR,BTC,EMAMI", {
  headers: { "Accept": "application/json" }
});
const data = await res.json();

$opts = ["http" => ["header" => "Accept: application/json\r\n"]];
$ctx = stream_context_create($opts);
$data = json_decode(file_get_contents("https://rates-api.mehrnet.com/historical?date=2026-08-14&symbols=USD,EUR,BTC,EMAMI", false, $ctx), true);

from urllib.request import Request, urlopen
import json

req = Request("https://rates-api.mehrnet.com/historical?date=2026-08-14&symbols=USD,EUR,BTC,EMAMI", headers={"Accept": "application/json"})
data = json.load(urlopen(req))

req, _ := http.NewRequest("GET", "https://rates-api.mehrnet.com/historical?date=2026-08-14&symbols=USD,EUR,BTC,EMAMI", nil)
req.Header.Set("Accept", "application/json")
resp, _ := http.DefaultClient.Do(req)
var data map[string]any
json.NewDecoder(resp.Body).Decode(&data)

200 OK

{
  "timestamp": 1786722592285,
  "date_iso": "2026-08-14T15:49:52.285Z",
  "base": "IRT",
  "currencies": {
    "USD": { "buy": 185893, "sell": 187000 },
    "EUR": { "buy": 215070, "sell": 216350 }
  },
  "coins": {
    "EMAMI": { "buy": 186500000, "sell": 189500000 }
  }
}

Time-Series Price Points

Chronological time-series stream for financial charting, sparklines, and algorithmic moving averages.

Supports ?symbol=USD, ?days=7, and ?interval=15m|1h|1d.

GET/timeseries?symbol=USD&days=7&interval=1h

curl -sS -H "Accept: application/json" "https://rates-api.mehrnet.com/timeseries?symbol=USD&days=7&interval=1h"

const res = await fetch("https://rates-api.mehrnet.com/timeseries?symbol=USD&days=7&interval=1h", {
  headers: { "Accept": "application/json" }
});
const data = await res.json();

$opts = ["http" => ["header" => "Accept: application/json\r\n"]];
$ctx = stream_context_create($opts);
$data = json_decode(file_get_contents("https://rates-api.mehrnet.com/timeseries?symbol=USD&days=7&interval=1h", false, $ctx), true);

from urllib.request import Request, urlopen
import json

req = Request("https://rates-api.mehrnet.com/timeseries?symbol=USD&days=7&interval=1h", headers={"Accept": "application/json"})
data = json.load(urlopen(req))

req, _ := http.NewRequest("GET", "https://rates-api.mehrnet.com/timeseries?symbol=USD&days=7&interval=1h", nil)
req.Header.Set("Accept", "application/json")
resp, _ := http.DefaultClient.Do(req)
var data map[string]any
json.NewDecoder(resp.Body).Decode(&data)

200 OK

{
  "symbol": "USD",
  "interval": "1h",
  "days": 7,
  "total_points": 168,
  "points": [
    {
      "timestamp": 1786722592285,
      "date_iso": "2026-08-14T15:49:52.285Z",
      "price": 187000,
      "buy": 185893,
      "sell": 187000
    }
  ]
}

OpenAPI 3.1 Specification

Official machine-readable JSON schema defining all endpoints, parameters, schemas, and responses.

Importable into Postman, Insomnia, Swagger UI, or code generation pipelines (openapi-generator, oapi-codegen).

GET/openapi.json

curl -sS -H "Accept: application/json" "https://rates-api.mehrnet.com/openapi.json"

const res = await fetch("https://rates-api.mehrnet.com/openapi.json");
const spec = await res.json();

$spec = json_decode(file_get_contents("https://rates-api.mehrnet.com/openapi.json"), true);

from urllib.request import urlopen
import json

spec = json.load(urlopen("https://rates-api.mehrnet.com/openapi.json"))

resp, _ := http.Get("https://rates-api.mehrnet.com/openapi.json")
var spec map[string]any
json.NewDecoder(resp.Body).Decode(&spec)

200 OK

{
  "openapi": "3.1.0",
  "info": {
    "title": "Mehr Rates API",
    "version": "1.0.0"
  },
  "servers": [
    { "url": "https://rates-api.mehrnet.com" }
  ],
  "paths": { ... }
}

Provider	Description	Monitored Assets	Status (Synced X ago)	Frequency

Total Active Network Coverage		--	--

Gold & Precious Metals

Energy & Commodities

Crypto Rates

Data Providers

Real-time Rates & Market Feed

Endpoint Specifications & Examples

Unified Rate Sheet

Targeted Query Filter

Parameters

Single Asset Rate

Parameters

Cross-Pair Conversion

Parameters

Providers Registry

Telemetry Logs

Parameters

Health & Status

Historical Rate Sheet

Time-Series Price Points

OpenAPI 3.1 Specification

Market Rates

Gold & Precious Metals

Energy & Commodities

Crypto Rates

Data Providers

Endpoint Specifications & Examples

Parameters

Parameters

Parameters

Parameters