Skip to main content
The DAG endpoints expose $DAG token economics data as recorded in the latest global snapshot. All amounts are denominated in datums — the smallest unit of DAG (1 DAG = 100,000,000 datums).
All endpoints return the following response headers:
  • X-Id — The node’s public key identifier
  • X-Session-Token — The current cluster session token
  • Request-Signature — Cryptographic signature of the response for verification

​
GET /dag/total-supply

Returns the total supply of $DAG as of the latest global snapshot. Total supply includes all DAG in existence, including locked and staked tokens. 
curl https://<node-host>:9000/dag/total-supply
Response 200 OK
​
total
integer
Total $DAG supply in datums (1 DAG = 100,000,000 datums)
​
ordinal
integer
The snapshot ordinal at which this supply was calculated
Example response: 
{
  "total": 350000000000000000,
  "ordinal": 1483920
}

​
GET /dag/circulated-supply

Returns the circulated supply of $DAG as of the latest global snapshot. Circulated supply excludes tokens held in treasury or reserve addresses. 
curl https://<node-host>:9000/dag/circulated-supply
Response 200 OK
​
circulated
integer
Circulated $DAG supply in datums
​
ordinal
integer
The snapshot ordinal at which this supply was calculated
Example response: 
{
  "circulated": 290000000000000000,
  "ordinal": 1483920
}

​
GET /dag//balance

Returns the $DAG balance for a given wallet address, as recorded in the latest global snapshot. 
curl https://<node-host>:9000/dag/DAG3hZTBgtb2iH9ZdLNvaKqPT4ZncCuW6uYxZack/balance
​
address
string
required
DAG wallet address (begins with DAG)
Response 200 OK
​
balance
integer
$DAG balance in datums
​
ordinal
integer
The snapshot ordinal at which this balance was recorded
Example response: 
{
  "balance": 5000000000,
  "ordinal": 1483920
}

Build docs developers (and LLMs) love

Get started for freeTalk to us