Nobitex APInobitex.ir ↗
Access real-time crypto prices, 24h volume, and market stats from Nobitex via 3 endpoints covering IRT pairs, USDT pairs, and all trading markets.
What is the Nobitex API?
The Nobitex API exposes live cryptocurrency market data from Iran's largest crypto exchange across 3 endpoints. The get_all_stats endpoint returns a keyed map of every active trading pair — including fields like bestSell, bestBuy, volume, and isClosed — while dedicated endpoints for get_usdt_irt and get_xrp_usdt deliver single-pair price data with explicit currency metadata.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/1307851f-494d-40b7-a7dc-7d96d252dd16/get_usdt_irt' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace nobitex-ir-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.nobitex_market_api import Nobitex, UsdtIrtPrice, XrpUsdtPrice, MarketOverview, PairStats
nobitex = Nobitex()
# Get USDT price in Iranian Toman
usdt_price = nobitex.markets.usdt_irt()
print(usdt_price.price, usdt_price.price_rial, usdt_price.unit)
# Get XRP price in USDT
xrp_price = nobitex.markets.xrp_usdt()
print(xrp_price.currency, xrp_price.price, xrp_price.unit)
# Get all market statistics
overview = nobitex.marketoverviews.get()
for pair_name, stats in overview.pairs.items():
print(pair_name, stats.latest, stats.day_change, stats.best_sell)
Get the current price of USDT in Iranian Toman (IRT). The upstream API returns values in Rial, which are converted to Toman (1 Toman = 10 Rial). Returns a single price record with both Toman and Rial values.
No input parameters required.
{
"type": "object",
"fields": {
"unit": "string, display unit (always 'Toman')",
"price": "number, current USDT price in Toman",
"quote": "string, the quote currency (always 'IRT')",
"currency": "string, the base currency (always 'USDT')",
"price_rial": "number, current USDT price in Rial"
},
"sample": {
"data": {
"unit": "Toman",
"price": 178915,
"quote": "IRT",
"currency": "USDT",
"price_rial": 1789150
},
"status": "success"
}
}About the Nobitex API
Endpoints and Response Shape
The API covers three focused endpoints. get_usdt_irt returns the current USDT/IRT exchange rate in both Toman (price) and Rial (price_rial), with the unit field always set to 'Toman'. This dual-unit response is useful when downstream systems require Rial-denominated values. get_xrp_usdt returns XRP priced in USDT with currency set to 'XRP' and quote set to 'USDT'.
Full Market Coverage via get_all_stats
get_all_stats is the broadest endpoint. It returns a map where each key is a pair identifier such as btc-rls or eth-usdt, and each value is an object with bestSell, bestBuy, volume, and isClosed. This covers both IRT-quoted (Rial/Toman) and USDT-quoted pairs in a single response, making it straightforward to build a full orderbook-style snapshot or a price aggregation table across all Nobitex markets.
Currency Denomination Notes
Nobitex internally quotes IRT-denominated prices in Rial. The get_usdt_irt endpoint handles this by returning both price (converted to Toman, dividing by 10) and price_rial (raw Rial value). The get_all_stats endpoint returns raw values from the source, so callers working with IRT pairs should apply their own Toman/Rial conversion as needed based on the pair suffix (-rls indicating Rial denomination).
The Nobitex API is a managed, monitored endpoint for nobitex.ir — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when nobitex.ir changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official nobitex.ir API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Display a live USDT/IRT rate on a currency converter dashboard using
pricefromget_usdt_irt - Track XRP/USDT price movements for alerting or charting using
get_xrp_usdt - Build a full Nobitex market overview table using
bestSell,bestBuy, andvolumefromget_all_stats - Monitor which Nobitex trading pairs are halted by checking the
isClosedfield inget_all_stats - Calculate bid-ask spread for any Nobitex pair using
bestBuyandbestSellfromget_all_stats - Aggregate 24-hour trading volume across all pairs using the
volumefield returned per pair inget_all_stats
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Nobitex have an official developer API?+
What does get_all_stats return for each trading pair?+
btc-rls, eth-usdt) maps to an object with four fields: bestSell (lowest ask), bestBuy (highest bid), volume (24-hour traded volume), and isClosed (boolean indicating whether the pair is currently halted).Does get_usdt_irt return both Rial and Toman values?+
price in Toman (divided by 10 from the source Rial value) and price_rial as the raw Rial figure. The unit field is always 'Toman' to make the denomination explicit.Are historical prices or OHLCV candlestick data available?+
Are all Nobitex trading pairs covered, or only a subset?+
get_all_stats returns every pair currently active on Nobitex in a single response, but the two single-pair endpoints cover only USDT/IRT and XRP/USDT specifically. You can fork this API on Parse and revise it to add dedicated single-pair endpoints for other assets like BTC/IRT or ETH/USDT.