curl --request GET \
--url https://nexus.gerowallet.io/api/midnight/{network}/dust/account-state/{address} \
--header 'X-Api-Key: <api-key>'import requests
url = "https://nexus.gerowallet.io/api/midnight/{network}/dust/account-state/{address}"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://nexus.gerowallet.io/api/midnight/{network}/dust/account-state/{address}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://nexus.gerowallet.io/api/midnight/{network}/dust/account-state/{address}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://nexus.gerowallet.io/api/midnight/{network}/dust/account-state/{address}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://nexus.gerowallet.io/api/midnight/{network}/dust/account-state/{address}")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://nexus.gerowallet.io/api/midnight/{network}/dust/account-state/{address}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"dust_balance": "<string>",
"dust_generating": "<string>",
"dust_cap": "<string>",
"night_registered": "<string>",
"dust_registration_status": "<string>",
"dust_generation_status": "<string>",
"dust_time_remaining_seconds": 123,
"based_on_block_height": 123,
"based_on_block_time": "<string>",
"settled": true
}Get DUST account state
Current DUST account state for a Midnight unshielded address: balance, per-second generation rate, and cap. Cheap; safe to poll. based_on_block_height and based_on_block_time (ISO-8601 UTC) are the tip of the Midnight indexer whose events fill the NIGHT UTxO ledger these figures are computed from, null until one has been read; settled is true when that block is at most 30 seconds old, meaning that indexer is current. While settled is false, show the figures as an estimate. settled does not cover the relay that copies the indexer’s events into that ledger, so it is not proof that a zero or Unregistered answer is final.
curl --request GET \
--url https://nexus.gerowallet.io/api/midnight/{network}/dust/account-state/{address} \
--header 'X-Api-Key: <api-key>'import requests
url = "https://nexus.gerowallet.io/api/midnight/{network}/dust/account-state/{address}"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://nexus.gerowallet.io/api/midnight/{network}/dust/account-state/{address}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://nexus.gerowallet.io/api/midnight/{network}/dust/account-state/{address}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://nexus.gerowallet.io/api/midnight/{network}/dust/account-state/{address}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://nexus.gerowallet.io/api/midnight/{network}/dust/account-state/{address}")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://nexus.gerowallet.io/api/midnight/{network}/dust/account-state/{address}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"dust_balance": "<string>",
"dust_generating": "<string>",
"dust_cap": "<string>",
"night_registered": "<string>",
"dust_registration_status": "<string>",
"dust_generation_status": "<string>",
"dust_time_remaining_seconds": 123,
"based_on_block_height": 123,
"based_on_block_time": "<string>",
"settled": true
}Authorizations
API key (programmatic access — recommended)
Send your API key in the X-Api-Key header. Keys start with nxs_ and are
created in the dashboard (or via POST /api/keys with a session JWT).
Each key is scoped to one chain and one network (for example
CARDANO_MAINNET), fixed at creation time. It cannot query a different network
on the same chain, and it cannot query a different chain at all. A mismatched
network parameter returns 400 Network Mismatch. Create one key per chain
and network under the same account.
This is the credential most integrations should use.