Developer APIs


The Testnet DiemScan Developer APIs are provided as a free community service and without warranty for the Diem Blockchain. As the current network is still in the TESTNET phase, expect the API end-points and data to change over time. Also expect frequent network testnet resets as the network continues to evolve.

There is a (soft) limit of 5 API calls/sec/ip. Both GET/POST requests are supported for all endpoints with a maximum return limit of 1000 records per api call. If you have any questions or suggestions please feel free to get in touch with us.


Get a list of Transactions by Address

(To get paginated results use page=<page number> and offset=<max records to return>.
To filter specific version use startversion=<version> or endversion=<version>.
To Sort use sort=asc / desc
Note: status: 0 = Success, 1 = Fail
(Returns up to a maximum of the last 1000 transactions only))


Get Version By Number

(Note: status: 0 = Success, 1 = Fail. (Returns up to a maximum of the last 10000 transactions only))


Get Total Supply of Diem

(Result returned in microdiem, to get value in LIB divide resultAbove/1000000)


Get Diem coins

(Restricted to a maximum of 100 LIB per request. (Amount in microdiem) Note: Testnet Network coins have NO actual monetary value)

Web Socket (Experimental - Subject to change)

The Testnet DiemScan exposes several data streams over standard WebSocket connections, which can be consumed by modern web browsers and server side WebSocket Libraries

To subscribe module messages from server, client shoud send subcription message to the server.

WebSocket URL


Subscribe Latest Version

{"event": "subscribe", "module": "version"}

Subscribe Total Supply of Diem

{"event": "subscribe", "module": "stats", "action": "librasupply"}

Subscribe Diem Balance for Address

{"event": "subscribe", "module": "account", "action": "balance", "address":"your address"}

Subscribe Transaction for Address

{"event": "subscribe", "module": "transaction", "action": "txlist", "address":"your address"}