Skip to main content
Use Gateway account endpoints to read MultiversX address state without choosing a shard observer.

Base URL

https://rust-gateway.xoxno.com
Responses use the MultiversX Gateway body shape: data, error, and code.

Endpoint Groups

NeedEndpoint
Full accountGET /address/{address}
BalanceGET /address/{address}/balance
NonceGET /address/{address}/nonce
UsernameGET /address/{address}/username
Computed shardGET /address/{address}/shard
Code hashGET /address/{address}/code-hash
Storage keysGET /address/{address}/keys, GET /address/{address}/key/{key}, POST /address/iterate-keys
ESDT and NFT dataGET /address/{address}/esdt, GET /address/{address}/nft/{tokenIdentifier}/nonce/{nonce}
Guardian dataGET /address/{address}/guardian-data
Bulk accountsPOST /address/bulk

Query Options

Most account endpoints accept historical state selectors:
ParamUse
onFinalBlockQuery latest finalized block.
onStartOfEpochQuery state at an epoch start.
blockNonceQuery at a block nonce.
blockHashQuery at a block hash.
blockRootHashQuery at a state root.
hintEpochProvide epoch hint for historical lookup.
forced-shard-idOverride automatic routing.

Request

curl "https://rust-gateway.xoxno.com/address/erd1..."

Success Response

{
  "data": {
    "account": {
      "address": "erd1...",
      "nonce": 42,
      "balance": "1000000000000000000"
    }
  },
  "error": "",
  "code": "successful"
}

Edge Cases

CaseBehaviorFix
HTTP 200 with errorObserver returned an operation-level failure.Treat the response as failed.
Historical selector unavailableSelected observer may not have the requested history.Retry with supported selectors or without historical params.
/address/{address}/shardComputed locally from the address.Use it to debug routing without observer dependency.
Bulk readAddresses are grouped by shard.Keep request size bounded in your client.

Verify

  • HTTP status is 200.
  • Response body has error: "".
  • Expected field exists under data.
  • Historical queries return data for the intended block selector.