Skip to main content

Addresses

This component of the REST API allows one to query information about Addresses (Accounts).

GET Get Address

https://gateway.multiversx.com/address/:bech32Address

This endpoint allows one to retrieve basic information about an Address (Account).

Path Parameters

ParamRequiredTypeDescription
bech32AddressREQUIREDstringThe Address to query.
info

If an account (that is not a smart contract, smart contracts cannot be guarded) has an activeGuardian and is guarded, the codeMetadata of the account should be Guarded.

GET Get Address Guardian Data

https://gateway.multiversx.com/address/:bech32Address/guardian-data

This endpoint allows one to retrieve the guardian data of an Address.

Path Parameters

ParamRequiredTypeDescription
bech32AddressREQUIREDstringThe Address to query.
caution

In the response example mentioned above, the account has already set the activeGuardian (using a SetGuardian transaction), guarded the account (with a GuardAccount transaction), and also set the pendingGuardian (using an unguarded SetGuardian transaction). We intentionally chose this scenario to display all the fields for blockInfo and guardianData.

GET Get Address Nonce

https://gateway.multiversx.com/address/:bech32Address/nonce

This endpoint allows one to retrieve the nonce of an Address.

Path Parameters

ParamRequiredTypeDescription
bech32AddressREQUIREDstringThe Address to query.

GET Get Address Balance

https://gateway.multiversx.com/address/:bech32Address/balance

This endpoint allows one to retrieve the balance of an Address.

Path Parameters

ParamRequiredTypeDescription
bech32AddressREQUIREDstringThe Address to query.

GET Get Address Username (herotag)

https://gateway.multiversx.com/address/:bech32Address/username

This endpoint allows one to retrieve the username / herotag of an Address (if any).

Path Parameters

ParamRequiredTypeDescription
bech32AddressREQUIREDstringThe Address to query.

GET Get Address Transactions (deprecated)

https://gateway.multiversx.com/address/:bech32Address/transactions

caution

This endpoint is deprecated. In order to fetch the Transactions involving an Address, use the transactions endpoint of MultiversX API, instead.

This endpoint allows one to retrieve the latest 20 Transactions sent from an Address.

Path Parameters

ParamRequiredTypeDescription
bech32AddressREQUIREDstringThe Address to query.
caution

This endpoint is not available on Observer Nodes. It is only available on MultiversX Proxy.

Currently, this endpoint is only available on the Official MultiversX Proxy instance.

This endpoint requires the presence of an Elasticsearch instance (populated through Observers) as well.

GET Get Storage Value for Address

https://gateway.multiversx.com/address/:bech32Address/key/:key

This endpoint allows one to retrieve a value stored within the Blockchain for a given Address.

Path Parameters

ParamRequiredTypeDescription
bech32AddressREQUIREDstringThe Address to query.
keyREQUIREDstringThe key entry to fetch.

The key must be hex-encoded.

GET Get all storage for Address

https://gateway.multiversx.com/address/:bech32Address/keys

This endpoint allows one to retrieve all the key-value pairs stored under a given account.

Path Parameters

ParamRequiredTypeDescription
bech32AddressREQUIREDstringThe Address to query.

ESDT tokens endpoints

There are a number of ESDT tokens endpoints that one can use to check all tokens of an address, balance for specific fungible or non-fungible tokens or so on.

Fungible tokens endpoints can be found here and non-fungible tokens endpoints can be found here.