Assets

Get an asset's price changes

GEThttps://api.arzdigital.com/v1/assets/{slug}/price-changes

X-API-Key headerHow credits work

USD and Toman changes over each window, computed from stored history.

Credit use: Each successful call costs 1 credit, whatever it returns.

An empty result and any error cost nothing.

GET/v1/assets/bitcoin/price-changes

curl -sS "https://api.arzdigital.com/v1/assets/bitcoin/price-changes" \
  -H "X-API-Key: YOUR_API_KEY"

Example response200

{
  "status": "success",
  "data": {
    "priceChangePercent1h": -0.12522892906683064,
    "priceChangePercent24h": 0.40601842030385354,
    "priceChangePercent7d": -2.3322668084640856,
    "priceChangePercent30d": -6.238073338699069,
    "priceChangePercent3m": 16.07316321119095,
    "priceChangePercent1y": -26.72854641515477,
    "priceChangePercentYTD": -13.513091700971092,
    "priceChangePercentIrt1h": -0.04172969896983506,
    "priceChangePercentIrt24h": -0.206540165017958,
    "priceChangePercentIrt7d": -3.2962247994361054,
    "priceChangePercentIrt30d": -5.832825161294052,
    "priceChangePercentIrt3m": 67.83941055030894,
    "priceChangePercentIrt1y": 81.757940467998,
    "priceChangePercentIrtYTD": 69.60640642404724
  }
}

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

Parameters

slugstringPathRequired
Asset slug, such as bitcoin.
Example: bitcoin

Request headers

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

Response

The asset's changes. A window with no usable data is null.

Response fields (16)

statusstring
dataobject
Percent changes. A window with no usable data is null.
data.priceChangePercent1hnumber | null
data.priceChangePercent24hnumber | null
data.priceChangePercent7dnumber | null
data.priceChangePercent30dnumber | null
data.priceChangePercent3mnumber | null
data.priceChangePercent1ynumber | null
data.priceChangePercentYTDnumber | null
data.priceChangePercentIrt1hnumber | null
data.priceChangePercentIrt24hnumber | null
data.priceChangePercentIrt7dnumber | null
data.priceChangePercentIrt30dnumber | null
data.priceChangePercentIrt3mnumber | null
data.priceChangePercentIrt1ynumber | null
data.priceChangePercentIrtYTDnumber | null

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