Global market

Get the total market cap chart

GEThttps://api.arzdigital.com/v1/global/market-cap/chart

X-API-Key headerHow credits work

Credit use: Each successful call costs 1 credit for every 100 points it returns, rounded up. For example, 250 points cost 3 credits.

An empty result and any error cost nothing.

GET/v1/global/market-cap/chart

curl -sS "https://api.arzdigital.com/v1/global/market-cap/chart?range=7d" \
  -H "X-API-Key: YOUR_API_KEY"

Example response200

{
  "status": "success",
  "meta": {
    "low_usd": {
      "time": 1793982000,
      "price_usd": 2534666436714.443,
      "irt_rate": 269803,
      "price_btc": 33586918.130243025784
    },
    "high_usd": {
      "time": 1794042000,
      "price_usd": 2553495646406.014,
      "irt_rate": 268899,
      "price_btc": 33567353.720620499558
    },
    "low_irt": {
      "time": 1794066600,
      "price_usd": 2535839554279.5444,
      "irt_rate": 268001,
      "price_btc": 33537840.10701242144
    },
    "high_irt": {
      "time": 1793984400,
      "price_usd": 2551550890100.6855,
      "irt_rate": 269910,
      "price_btc": 33634177.472361067942
    }
  },
  "data": [
    {
      "time": 1793982000,
      "price_usd": 2534666436714.443,
      "irt_rate": 269803,
      "price_btc": 33586918.130243025784
    },
    {
      "time": 1793982300,
      "price_usd": 2543888746165.666,
      "irt_rate": 269969,
      "price_btc": 33593344.764221165966
    },
    {
      "time": 1793982600,
      "price_usd": 2545450314084.049,
      "irt_rate": 270000,
      "price_btc": 33584364.623272091436
    },
    {
      "time": 1793982900,
      "price_usd": 2549024663116.233,
      "irt_rate": 270059,
      "price_btc": 33666559.18849434625
    }
  ]
}

Run these from your server. The API sends no CORS headers, so a browser will block the call.

Parameters

rangestringQueryRequired
Window ending now.
1d7d1m3m6m1yall

Request headers

X-API-KeystringRequired
Your API key. Send it in this header on every call; it is not accepted in the URL.

Response

Chart points. The same shape as an asset chart, with the market cap in price_usd and price_btc.

Response fields (27)

statusstring
metaobject
meta.low_usdobject | null
meta.low_usd.timeinteger
Unix seconds.
meta.low_usd.price_usdnumber
Price in USD.
meta.low_usd.irt_ratenumber
Whole Toman per unit of the USD price.
meta.low_usd.price_btcnumber
Price in BTC.
meta.high_usdobject | null
meta.high_usd.timeinteger
Unix seconds.
meta.high_usd.price_usdnumber
Price in USD.
meta.high_usd.irt_ratenumber
Whole Toman per unit of the USD price.
meta.high_usd.price_btcnumber
Price in BTC.
meta.low_irtobject | null
meta.low_irt.timeinteger
Unix seconds.
meta.low_irt.price_usdnumber
Price in USD.
meta.low_irt.irt_ratenumber
Whole Toman per unit of the USD price.
meta.low_irt.price_btcnumber
Price in BTC.
meta.high_irtobject | null
meta.high_irt.timeinteger
Unix seconds.
meta.high_irt.price_usdnumber
Price in USD.
meta.high_irt.irt_ratenumber
Whole Toman per unit of the USD price.
meta.high_irt.price_btcnumber
Price in BTC.
dataarray
data[].timeinteger
Unix seconds.
data[].price_usdnumber
Price in USD.
data[].irt_ratenumber
Whole Toman per unit of the USD price.
data[].price_btcnumber
Price in BTC.

Response headers

X-Credits-Charged
Credits this call cost. 0 on every non-200 response.
X-Credits-Remaining
Account balance after this call, not counting what calls still in flight have set aside. Negative only for an account in debt after an adjustment.
X-RateLimit-Limit
Requests per minute allowed for this key.
X-RateLimit-Remaining
Requests left in the current window.
X-RateLimit-Reset
Unix seconds at which the window has room again.

Errors

bad_requesterror_code 1001
A parameter is missing

Errors are never charged. Errors