Docs

Docs

  • Develop
  • Validate
  • Integrate
  • Learn

โ€บREST API

Welcome to Elrond

  • Welcome to Elrond

Technology

  • Architecture Overview
  • Entities
  • Chronology
  • Secure Proof of Stake
  • Adaptive State Sharding
  • The Arwen WASM VM
  • Cross Shard Transactions

Wallet

  • Web Wallet
  • Ledger

Validators

  • Overview
  • System Requirements
  • Install a Mainnet Node

    • Scripts & User config
    • Installing a Validator Node
    • Optional Configurations
    • How to use the Docker Image

    Install a Testnet Node

    • Scripts & User config
    • Installing & updating
    • Manage your testnet node

    Install a Devnet Node

    • Scripts & User config
    • Installing & updating
    • Manage your devnet node

    Manage your keys

    • Validator Keys
    • Wallet Keys
    • Protecting your keys

    Staking, Unstaking, Unjailing

    • Staking, unstaking and unjailing
    • Staking
    • Unjailing
  • Rating
  • Node CLI
  • Useful Links & Tools
  • FAQs

Developers

    Tutorials

    • The Counter Smart Contract
    • Start Building - Crowdfunding Tutorial
    • The Crowdfunding Smart Contract (part 2)

    Signing Transactions

    • Signing Transactions
    • Tools for signing
    • Signing programmatically
  • ESDT tokens
  • The Staking Smart Contract
  • Developer reference

    • Mandos tests reference
    • The Elrond Serialization Format
  • Setup a Local Testnet
  • Setup a Local Testnet (advanced)
  • Creating Wallets

SDK and Tools

    REST API

    • REST API
    • Addresses
    • Transactions
    • Network
    • Nodes
    • Blocks
    • Virtual Machine
    • Versions and Changelog
  • Proxy
  • erdpy

    • erdpy
    • Installing erdpy
    • Configuring erdpy
    • erdpy CLI
    • Deriving the Wallet PEM file
    • Sending bulk transactions
    • Writing and running erdpy scripts
  • erdjs
  • erdgo
  • erdjava
  • erdwalletjs-cli

Integrators

  • Observing Squad
  • Accounts Management
  • Creating Transactions
  • Querying the Blockchain

Detailed comparison

  • Overview
  • Elrond vs. Ethereum Serenity
  • Elrond vs. Zilliqa
  • Elrond vs. Dfinity
  • Elrond vs. Algorand
  • Elrond vs. Harmony

Addresses

Get information about an Elrond Address.

GET Get Address

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

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

Request
Response

Path Parameters

ParamRequiredTypeDescription
bech32AddressREQUIREDstringThe Address to query.

๐ŸŸข 200: OK

Address information successfully retrieved.

{
"account": {
"address": "erd1l453hd0gt5gzdp7czpuall8ggt2dcv5zwmfdf3sd3lguxseux2fsmsgldz",
"nonce": 5,
"balance": "100000000000000000000"
}
}

GET Get Address Nonce

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

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

Request
Response

Path Parameters

ParamRequiredTypeDescription
bech32AddressREQUIREDstringThe Address to query.

๐ŸŸข 200: OK

Nonce successfully retrieved.

{
"nonce": 5
}

GET Get Address Balance

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

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

Request
Response

Path Parameters

ParamRequiredTypeDescription
bech32AddressREQUIREDstringThe Address to query.

๐ŸŸข 200: OK

Balance successfully retrieved.

{
"balance": "100000000000000000000"
}

GET Get Address Transactions

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

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

Request
Response

Path Parameters

ParamRequiredTypeDescription
bech32AddressREQUIREDstringThe Address to query.

๐ŸŸข 200: OK

Transactions successfully retrieved.

{
"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
},
...
]
}
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 Elastic Search instance (populated through Observers) as well.

GET Get Storage Value for Address

https://api.elrond.com/address/:bech32Address/storage/:storageKey

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

Request
Response

Path Parameters

ParamRequiredTypeDescription
bech32AddressREQUIREDstringThe Address to query.
storageKeyREQUIREDstringThe storage entry to fetch.

๐ŸŸข 200: OK

Value (hex-encoded) successfully retrieved.

{
"value": "abba"
}
โ† REST APITransactions โ†’
  • GET Get Address
  • GET Get Address Nonce
  • GET Get Address Balance
  • GET Get Address Transactions
  • GET Get Storage Value for Address
Made withby the Elrond team.
GithubChat
Main siteWalletExplorerBridgeDocs