Addresses

Get information about an Elrond Address.

GET Get Address

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

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

Path Parameters

ParamRequiredTypeDescription
bech32AddressREQUIREDstringThe Address to query.

🟢 200: OK

Address information successfully retrieved.

{
    "data": {
      "account": {
          "address": "erd1qqqqqqqqqqqqqqqpqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqylllslmq6y6",
          "nonce": 0,
          "balance": "100000000000000000000",
          "username": "",
          "code": "000000000000000000010000000000000000000000000000000000000004ffff",
          "codeHash": "YspAmEhzTEaqNOZlw+E+bPQx4JnfLJk4Fa/gtKas5fI=",
          "rootHash": "JF2QNq8wpVGijn9vvoSV+vGqTbuKVK1LIj7IlA21JXE=",
          "codeMetadata": "BAA=",
          "developerReward": "5670000000000000",
          "ownerAddress": "erd1l453hd0gt5gzdp7czpuall8ggt2dcv5zwmfdf3sd3lguxseux2fsmsgldz"
    },
    "error": "",
    "code": "success"
}

GET Get Address Nonce

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

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

Path Parameters

ParamRequiredTypeDescription
bech32AddressREQUIREDstringThe Address to query.

🟢 200: OK

Nonce successfully retrieved.

{
  "data": {
    "nonce": 5
  },
  "error": "",
  "code": "successful"
}

GET Get Address Balance

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

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

Path Parameters

ParamRequiredTypeDescription
bech32AddressREQUIREDstringThe Address to query.

🟢 200: OK

Balance successfully retrieved.

{
  "data": {
    "balance": "100000000000000000000"
  },
  "error": "",
  "code": "successful"
}

GET Get Address Username (herotag)

https://gateway.elrond.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.

🟢 200: OK

Balance successfully retrieved.

{
  "data": {
    "username": "docs.elrond"
  },
  "error": "",
  "code": "successful"
}

GET Get Address Transactions

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

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

Path Parameters

ParamRequiredTypeDescription
bech32AddressREQUIREDstringThe Address to query.

🟢 200: OK

Transactions successfully retrieved.

{
  "data": {
    "transactions": [
      {
        "hash": "1a3e...",
        "fee": "10000000000000000",
        "miniBlockHash": "9673...",
        "nonce": 68,
        "round": 33688,
        "value": "1000000000000000000",
        "receiver": "erd1...",
        "sender": "erd1l453hd0gt5gzdp7czpuall8ggt2dcv5zwmfdf3sd3lguxseux2fsmsgldz",
        "receiverShard": 0,
        "senderShard": 0,
        "gasPrice": 200000000000,
        "gasLimit": 50000,
        "gasUsed": 50000,
        "data": "",
        "signature": "ed75...",
        "timestamp": 1591258128,
        "status": "Success",
        "scResults": null
      },
      {
        "hash": "d72d...",
        "fee": "10000000000000000",
        "miniBlockHash": "fd45...",
        "nonce": 67,
        "round": 27353,
        "value": "100000000000000000000000000",
        "receiver": "erd1...",
        "sender": "erd1l453hd0gt5gzdp7czpuall8ggt2dcv5zwmfdf3sd3lguxseux2fsmsgldz",
        "receiverShard": 1,
        "senderShard": 0,
        "gasPrice": 200000000000,
        "gasLimit": 50000,
        "gasUsed": 50000,
        "data": "",
        "signature": "bb98...",
        "timestamp": 1591220142,
        "status": "Success",
        "scResults": null
      },
      ...
    ]
  },
  "error": "",
  "code": "successful"
}
warning

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

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

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

GET Get Storage Value for Address

https://gateway.elrond.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.

🟢 200: OK

Value (hex-encoded) successfully retrieved.

{
    "data": {
        "value": "abba"
    },
    "error": "",
    "code": "successful"
}

GET Get all storage for Address

https://gateway.elrond.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.

🟢 200: OK

Key-value pairs (both hex-encoded) successfully retrieved.

{
    "data": {
        "pairs": {
            "abba": "6f6b"
            ...
        }
    },
    "error": "",
    "code": "successful"
}

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.

← Gateway overviewTransactions →