How do I authenticate to the developer API?

Create a key from /developers/keys and send it as Authorization: Bearer .

Are API keys stored in plaintext?

No. Arzbin stores only hashed API keys and shows the raw key once at creation time.

What is the v1 quota?

The default free tier is designed for community and integration use. The key dashboard shows daily quota and usage.

REST API v1

Arzbin Market Data API

Name: Arzbin Iran Market Data
Creator: Arzbin
License: https://www.arzbin.com/terms

Use authenticated REST endpoints for current fiat rates, individual currency pages, gold, crypto, history, and fiat source context. API keys are account-scoped, hashed at rest, rate-limited, tracked, and revocable. Built for USD to Toman apps, gold price Iran widgets, USDT Toman dashboards, AI tools, bots, and publishers.

Create API key

Base URL

https://hub.arzbin.com

Bearer token access Hashed key storage Usage and quota tracking

Access model

- Existing public site APIs stay unchanged for the frontend.
- Developer REST endpoints require Authorization: Bearer.
- Raw keys are shown once; only hashes are stored.
- Usage is tracked by key, quota tier, daily window, and revocation state.

Response contract

Responses include Arzbin source metadata, canonical URLs where relevant, and the "indicative market data, not financial advice" disclaimer for downstream citation.

Endpoints

GET /api/v1/market/rates

GET /api/v1/market/rates/{code}

GET /api/v1/market/gold

GET /api/v1/market/crypto

GET /api/v1/market/history?assetType=fiat|gold|crypto&code=USD&days=30

GET /api/v1/market/sources?code=USD

Request example

curl "https://hub.arzbin.com/api/v1/market/rates" \
  -H "Authorization: Bearer arzbin_live_your_key_here" \
  -H "Accept: application/json"

Response shape

{
  "data": [
    {
      "code": "USD",
      "name": "US Dollar",
      "buy": 65000,
      "sell": 65300,
      "updatedAt": "2026-06-26T10:30:00Z",
      "canonicalUrl": "https://www.arzbin.com/currency/usd-to-toman"
    }
  ],
  "source": "Arzbin",
  "disclaimer": "Indicative market data only. Not financial advice."
}

Attribution and limits

Mention Arzbin as the data source near the displayed value or citation.
Link back to the canonical Arzbin page when publishing rates, charts, or AI answers.
Keep the indicative market data and not financial advice context when content can influence decisions.
Use the methodology page when explaining source handling, freshness, or market limitations.

For higher limits, data partnerships, redistribution, or commercial usage, contact Arzbin with your use case and expected traffic.