MultiversX Gateway API
v1.1.0https://egld-api.nownodes.iohttps://egld.nownodes.ioAPI for interacting with the MultiversX blockchain network
Authentication
apiKeyapiKeyAPI key for authentication
API Key: api-key in header
Gateway
Accounts
Get a list of accounts
Returns a paginated list of accounts with their balances and metadata.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get total number of accounts
Returns the total count of accounts on the network.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get account details by address
Retrieves detailed information for a single account, including balance, nonce, and state proof data.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get tokens held by an account
Returns a list of ESDT (fungible) tokens owned by the specified account, including metadata, balances, and market data.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get token count for an account
Returns the total number of distinct ESDT (fungible) tokens owned by the specified account.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get specific token details for an account
Retrieves detailed information about a single ESDT token owned by the specified account, including metadata, supply, permissions, and the account's balance.
Parameters
addressstringrequiredpathAccount address in bech32 format
tokenIdentifierstringrequiredpathToken identifier (ticker + random suffix)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get collections held by an account
Returns a list of NFT (Non-Fungible ESDT) and SFT (Semi-Fungible ESDT) collections that the specified account owns at least one token from.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get collection count for an account
Returns the total number of distinct NFT (Non-Fungible ESDT) and SFT (Semi-Fungible ESDT) collections that the specified account owns at least one token from.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get collection roles with detailed metadata for an account
Retrieves all collections where the specified account holds special roles, returning extended collection information (traits, auction stats, assets) and role permissions for that account.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get account roles for a specific collection
Retrieves full information about a collection (NFT/SFT) together with the role assignment and permissions of the specified account on that collection.
Parameters
addressstringrequiredpathAccount address in bech32 format
collectionstringrequiredpathCollection identifier (ticker + random suffix)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get token roles for an account
Retrieves all ESDT tokens (fungible, semi‑fungible, non‑fungible) where the given account has one or more special roles (local mint, local burn, NFT create, add quantity, update attributes, add URI, etc.). Returns full token details together with the account’s role assignment.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get count of tokens where the account has roles
Counts all distinct tokens (by identifier) where the given account possesses any special ESDT role, such as local mint, local burn, NFT create, add quantity, update attributes, or add URI.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get account roles for a specific token
Retrieves full token metadata and the role assignment (local mint, local burn, create, burn, add quantity, update attributes, add URI, transfer) that the specified account possesses on that exact token identifier.
Parameters
addressstringrequiredpathAccount address in bech32 format
tokenIdentifierstringrequiredpathToken identifier (ticker + random suffix)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get NFTs owned by an account
Retrieves all NFTs and SFTs (non-fungible and semi-fungible ESDT tokens) held by the specified account. Each item includes token identifier, collection, attributes, name, creator, royalties, URIs, media files, tags, and balance.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get NFT count for an account
Counts all distinct NFT and SFT tokens (by identifier) that the specified account holds. Each distinct NFT or SFT token is counted individually.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get a specific NFT owned by an account
Retrieves detailed information about a single NFT or SFT token (by its full identifier, e.g., collection-nonce) held by the specified account.
Parameters
addressstringrequiredpathAccount address in bech32 format
identifierstringrequiredpathFull NFT identifier (collection identifier + nonce, e.g., "ESDT-f5690f-d5")
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get stake information for an account
Retrieves staking and validator-related data associated with the specified account. This includes counts of validators and observers, staked amounts, auction queue size, and other staking network metrics.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get delegation details for an account
Retrieves the delegation data for the specified account, including stake information for each delegation contract the account is participating in. Returns active stake, rewards, and pending undelegation amounts.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get legacy delegation details for an account
Retrieves legacy delegation data for the specified account, including withdraw‑only stake, waiting stake, active stake, unstaked stake, deferred payment stake, and claimable rewards. This endpoint is used for the legacy delegation contract system.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get BLS keys for an account
Retrieves all BLS (Boneh–Lynn–Shacham) public keys registered for the specified account, typically used for validator nodes. Each key entry includes staking details, top-up amount, node status, queue position, and remaining unbonding period.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get waiting list entries for an account
Retrieves the waiting list (queue) positions for the specified account. Each entry contains the reward address, nonce, rank in the queue, and the queued value.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get transactions for an account
Retrieves a paginated list of transactions associated with the specified account. Transactions can be both sent and received, sorted by nonce and timestamp.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get transaction count for an account
Counts all transactions linked to the given account, including incoming and outgoing transfers and smart contract interactions.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get transfers for an account
Retrieves a paginated list of transfer transactions (both sent and received) associated with the specified account. Each entry includes full transaction details and a type field (e.g., "Transaction").
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get transfer count for an account
Counts all transfer transactions (both incoming and outgoing) linked to the given account.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get contract deployments for an account
Retrieves all smart contracts deployed by the specified account, including the deployment transaction hash, timestamp, and assets metadata.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get contract deployment count for an account
Counts all smart contracts that have been deployed by the given account.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get contracts deployed by an account
Retrieves all smart contracts that have been deployed by the given account. Each entry contains the contract address, deployment transaction hash, timestamp, and associated assets.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get contract deployment count for an account
Counts how many smart contracts have been deployed by the given account.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get contract upgrade details for an account
Retrieves information about the last smart contract upgrade performed by the given account, including the contract address, transaction hash, code hash, and timestamp.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get transaction results for an account
Retrieves a list of transaction results (also known as receipts or logs) associated with the specified account. These results contain detailed information about the outcome of transactions, including executed operations, events, and transfer details.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get transaction results count for an account
Counts all transaction results (including incoming and outgoing events) linked to the given account.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get a specific transaction result for an account
Retrieves detailed information about a single transaction result (receipt/event) identified by its hash and associated with the given account.
Parameters
addressstringrequiredpathAccount address in bech32 format
hashstringrequiredpathTransaction result hash (transaction hash or receipt hash)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get account balance history
Retrieves a list of historical balance snapshots for the given account, including the address, balance in atomic units, timestamp, and an optional flag indicating whether the account was the sender in the transaction that caused the balance change.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get account balance history count
Counts all historical balance records (snapshots) for the specified account.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get token balance history for an account
Retrieves a list of historical balance snapshots for a specific ESDT token held by the given account, including the address, token balance in atomic units, timestamp, and an optional flag indicating whether the account was the sender in the transaction that caused the balance change.
Parameters
addressstringrequiredpathAccount address in bech32 format
tokenIdentifierstringrequiredpathToken identifier (ticker + random suffix)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get token balance history count for an account
Counts all historical balance records for a specific token owned by the given account.
Parameters
addressstringrequiredpathAccount address in bech32 format
tokenIdentifierstringrequiredpathToken identifier (ticker + random suffix)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get ESDT token balance history for an account
Retrieves a list of historical balance snapshots for all ESDT tokens held by the given account. Each entry includes the token identifier, balance in atomic units, timestamp, and for NFTs/SFTs, the full identifier (collection + nonce). An optional isSender flag indicates if the account was the sender in the transaction that caused the change.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get ESDT history entry count for an account
Counts all historical balance records (snapshots) for ESDT tokens (fungible, semi‑fungible, non‑fungible) associated with the given account.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Blocks
Get blocks
Retrieves a paginated list of blocks, including shard blocks (shard 0, 1, 2) and meta‑blocks (shard 4294967295). Each block contains header information, gas metrics, and transaction statistics.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get total number of blocks
Counts all blocks across all shards (0, 1, 2) and the meta‑chain (shard 4294967295) that have been produced up to the current moment.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get the latest block
Retrieves the most recently produced block (by default from shard 0, can be overridden with query parameters in actual implementation). The response includes full block header information, gas metrics, and transaction statistics.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get block by hash (using query parameter)
Retrieves a specific block identified by its hash. The hash is provided as a query parameter hash. The response includes full block header information, gas metrics, and transaction statistics.
Parameters
hashstringrequiredqueryBlock hash (hexadecimal string)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Collections
Get all NFT/SFT collections
Retrieves a paginated list of collections (ESDT tokens of type NonFungibleESDT, SemiFungibleESDT, or MetaESDT). Each collection entry includes basic metadata and permission flags.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get total number of collections
Counts all collections (NonFungibleESDT, SemiFungibleESDT, and MetaESDT) registered on the MultiversX blockchain.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get collection details by identifier
Retrieves detailed information about a single NFT/SFT collection identified by its collection ticker (e.g., AREPASS-76b676). Includes global flags and the list of roles assigned to various addresses (including the owner). Roles can include ESDTRoleNFTCreate, ESDTRoleNFTBurn, ESDTRoleNFTAddQuantity, ESDTRoleBurnForAll, etc.
Parameters
collectionstringrequiredpathCollection identifier (ticker + random suffix)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get token ranks for a collection
Retrieves the rank of each NFT in the collection based on a predefined ranking algorithm (e.g., trait rarity). The response maps each full token identifier (collection + nonce) to its rank (lower number = higher rank). Ranks are typically 1‑based.
Parameters
collectionstringrequiredpathCollection identifier (ticker + random suffix)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get all NFTs / SFTs in a collection
Retrieves a paginated list of tokens (NFTs or SFTs) that belong to the specified collection. Each token includes its full identifier, name, image URIs, royalties, attributes, creator, and other on‑chain metadata.
Parameters
collectionstringrequiredpathCollection identifier (ticker + random suffix)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get number of NFTs in a collection
Counts how many distinct tokens (by nonce) exist within the specified collection.
Parameters
collectionstringrequiredpathCollection identifier (ticker + random suffix)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get token holders of a collection
Retrieves a list of accounts that own tokens from the specified collection. For fungible‑like collections (SFTs) and NFTs, each entry shows the owner address and the balance they hold (usually a quantity for SFTs, or 1 for NFTs). The same address may appear multiple times if it holds tokens with different nonces (different token types within the collection).
Parameters
collectionstringrequiredpathCollection identifier (ticker + random suffix)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get transactions for a collection
Retrieves a paginated list of transactions that affect the given collection. The response includes full transaction details and an action field describing the operation (e.g., transfer, creation, multi‑transfer).
Parameters
collectionstringrequiredpathCollection identifier (ticker + random suffix)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get transaction count for a collection
Counts all transactions that include tokens from the given collection (mint, transfer, burn, or any interaction with the collection's tokens).
Parameters
collectionstringrequiredpathCollection identifier (ticker + random suffix)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get transfer events for a collection
Retrieves a paginated list of transfer events (SmartContractResult objects) where tokens from the given collection were involved. Each transfer entry contains details about the sender, receiver, transferred tokens, and the original transaction hash.
Parameters
collectionstringrequiredpathCollection identifier (ticker + random suffix)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get transfer count for a collection
Counts all transfer events (SmartContractResult records) where tokens from the given collection were involved.
Parameters
collectionstringrequiredpathCollection identifier (ticker + random suffix)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Identities
Get validator identities (staking providers)
Retrieves a paginated list of identities. If the identifier query parameter is provided, the list can be filtered to a specific identity slug (e.g., multiversx). The response includes stake, top‑up, score, rank, APR, validator count, and metadata.
Parameters
identifierstringqueryFilter by a specific identity identifier (e.g., multiversx). When provided, the response may return a single object in an array or a filtered list.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get avatar for a validator identity
Retrieves the avatar URL (or directly the image content) for the given identity identifier (e.g., multiversx). The response typically contains a JSON object with an avatar field.
Parameters
identifierstringrequiredqueryIdentity identifier (slug)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Nodes
Get all validator nodes
Retrieves a paginated list of validator nodes on the network. Each node entry contains BLS key, name, software version, rating, shard assignment, operational status, stake amounts, performance counters, and optional auction/queue information.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get node versions distribution
Retrieves a map of node software versions to their relative share (proportion) among all validator nodes. Each value is a float between 0 and 1, representing the fraction of nodes running that version.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get total number of validator nodes
Counts all registered validator nodes across all shards and the meta-chain.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get auction validator nodes
Retrieves a list of validator nodes that are part of the auction mechanism. Each entry may represent a node (with BLS key) or an aggregated view per provider/identity, containing stakes, top‑up amounts, and counts of qualified, dropped, or danger‑zone validators.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get validator node details by BLS key
Retrieves detailed information about a single validator node using its BLS public key. The response includes node metadata, performance metrics, stake, top‑up, status, and auction information.
Parameters
blsstringrequiredpathBLS public key of the validator node (hexadecimal)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Keys
Get remaining unbonding period for a validator node
Retrieves the number of epochs remaining until the validator node is fully unbonded. This endpoint is useful for nodes that are inactive or in the process of being removed.
Parameters
blsstringrequiredpathBLS public key of the validator node (hexadecimal)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Miniblocks
Get mini‑blocks
Retrieves a paginated list of mini‑blocks. Each mini‑block represents a batch of transactions or smart contract results that are processed together within a block. The response includes the mini‑block hash, sender and receiver block hashes, shard identifiers, timestamp, and the type of the mini‑block.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get mini‑block details by hash
Retrieves a single mini‑block object using its hash. The response includes the mini‑block hash, sender and receiver block hashes, shard identifiers, timestamp, and the type of the mini‑block (TxBlock or SmartContractResultBlock).
Parameters
miniBlockHashstringrequiredpathHash of the mini‑block (unique identifier)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Network
Get network constants
Retrieves a set of network‑wide constants that define transaction parameters such as minimum gas limits, gas price, and chain ID.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get network economics
Retrieves key economic data for the MultiversX blockchain, such as total and circulating supply, total staked EGLD, and various APR metrics (overall, top‑up, base).
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get service information
Retrieves information about the API gateway and indexer, including the network type (mainnet, devnet, testnet), software versions, and which optional API features are enabled.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get network statistics
Retrieves high‑level network metrics such as the number of shards, blocks, accounts, transactions, smart contract results, current epoch, and rounds progress.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Nfts
Get NFTs and SFTs
Retrieves a paginated list of NFTs and SFTs. Each entry contains full metadata, URIs, media information, rarity scores (if computed), and asset links.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get total number of NFTs/SFTs
Counts all distinct NFT and SFT tokens across all collections registered on the MultiversX blockchain.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get NFT/SFT details by identifier
Retrieves detailed metadata for a single token (NFT or SFT) using its full identifier (e.g., collection-nonce). The response includes the token’s name, image URIs, attributes, media, creator, royalties, and the current owner.
Parameters
identifierstringrequiredpathFull token identifier (collection + nonce)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get supply of a specific NFT/SFT token
Retrieves the total supply (circulating supply) of the token identified by its full identifier. For NFTs this is typically "1", for SFTs it may be higher.
Parameters
identifierstringrequiredpathFull token identifier (collection + nonce)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get token holders of a specific NFT/SFT token
Retrieves all accounts that own at least one unit of the given token (by full identifier). For NFTs, the balance is typically "1". For SFTs, balances can be larger.
Parameters
identifierstringrequiredpathFull token identifier (collection + nonce)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get number of holders for a specific NFT/SFT token
Counts all distinct accounts that own at least one unit of the token identified by its full identifier.
Parameters
identifierstringrequiredpathFull token identifier (collection + nonce)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get transactions for a specific NFT/SFT token
Retrieves a paginated list of transactions (transfers, minting, burning) that involve the token identified by its full identifier. Each transaction includes details like hash, gas, status, timestamp, and a structured action field.
Parameters
identifierstringrequiredpathFull token identifier (collection + nonce)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get transaction count for a specific NFT/SFT token
Counts all transactions that affect the token identified by its full identifier.
Parameters
identifierstringrequiredpathFull token identifier (collection + nonce)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get transfer events for a specific NFT/SFT token
Retrieves a paginated list of transfer events (regular transactions and SmartContractResult objects) that involve the token identified by its full identifier. Each entry includes sender/receiver, status, timestamp, and structured action data.
Parameters
identifierstringrequiredpathFull token identifier (collection + nonce)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get transfer event count for a specific NFT/SFT token
Counts all transfer events (regular transactions and SmartContractResult objects) that involve the token identified by its full identifier.
Parameters
identifierstringrequiredpathFull token identifier (collection + nonce)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Providers
Get delegation providers
Retrieves a paginated list of delegation smart contracts (staking providers) on the MultiversX network. Each provider entry includes stake amounts, number of validators, APRs, delegation cap, service fee, and aggregated statistics.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get delegation provider details by address
Retrieves comprehensive data for a specific delegation provider contract, including stake, fees, APR, number of users, cumulative rewards, and contract‑specific parameters like delegation cap and automatic activation flags.
Parameters
providerstringrequiredpathDelegation contract address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get delegation provider avatar
Retrieves the avatar image URL (or redirects to the image) associated with the given delegation provider contract. If the provider has an associated identity, the avatar from that identity is returned; otherwise a default or placeholder may be provided.
Parameters
providerstringrequiredpathDelegation contract address in bech32 format
Response
Successful response (JSON containing avatar URL)
Authorization
apiKeyapiKey in headerAPI key for authentication
Get delegator accounts for a provider
Retrieves a paginated list of all accounts that have delegated EGLD to the specified delegation provider (staking contract). Each entry contains the delegator's address and the amount they have staked (in atomic units).
Parameters
providerstringrequiredpathDelegation contract address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get number of delegator accounts for a provider
Counts all distinct accounts that have delegated EGLD to the specified delegation provider (staking contract).
Parameters
providerstringrequiredpathDelegation contract address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Rounds
Get rounds
Retrieves a paginated list of consensus rounds across all shards. Each entry indicates whether a block was proposed in that round for a given shard, along with the round number, epoch, and timestamp.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get total number of rounds
Counts all consensus rounds across all shards that have been recorded up to the current moment.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get round details by shard and round number
Retrieves detailed information about a specific consensus round, including whether a block was proposed, the epoch, timestamps, and the list of BLS keys of validators who signed the block.
Parameters
shardintegerrequiredpathShard identifier (0,1,2 for regular shards, 4294967295 for meta‑chain)
roundintegerrequiredpathRound number (consensus round)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Results
Get transaction results
Retrieves a paginated list of transaction results (also known as receipts or logs). These entries record the outcome of executed transactions, including smart contract calls, token transfers, and refunds. Each result contains a hash, status, gas information, and optionally structured actions (e.g., ESDT/NFT transfers).
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get total number of transaction results
Counts all transaction results (including receipts, logs, and internal operations) across the entire network.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get transaction result by hash
Retrieves a specific transaction result (receipt, log, or outcome) for a given hash. This endpoint returns detailed execution information, including gas usage, value transfer, sender and receiver, and optional return messages.
Parameters
hashstringrequiredpathTransaction result hash (hexadecimal string)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Shards
Get shards information
Retrieves a list of shards, including the meta‑chain (shard 4294967295), along with the total number of validators and the number of active validators on each shard.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Stake
Get global stake statistics
Retrieves high‑level staking metrics for the entire network, such as the total number of validators (and active ones), total observers, queue size, and the total amount of EGLD staked.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Tokens
Get fungible tokens
Retrieves a paginated list of fungible ESDT tokens on the network. Each token entry includes metadata (name, ticker, decimals), permissions (e.g., mint, burn, pause), supply, price, market cap, liquidity, trading volume, and historical ownership changes.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get total number of fungible tokens
Counts all distinct fungible ESDT tokens registered on the MultiversX blockchain.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get token details by identifier
Retrieves comprehensive data for a single fungible ESDT token, including metadata, supply, permissions, mint/burn amounts, transfer counts, and role assignments.
Parameters
identifierstringrequiredpathToken identifier (ticker + random suffix)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get supply details of a specific token
Retrieves the supply-related data for a given fungible ESDT token, such as total supply, circulating supply, total minted and burnt amounts, and the initial minted supply at creation.
Parameters
identifierstringrequiredpathToken identifier (ticker + random suffix)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get token holders for a specific token
Retrieves a paginated list of accounts that own the given fungible ESDT token. Each entry includes the account address, its balance in atomic units, and optional asset metadata (e.g., exchange name, social links, icons) if the account is known.
Parameters
identifierstringrequiredpathToken identifier (ticker + random suffix)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get number of token holders for a specific token
Counts all distinct accounts that own at least one unit of the given fungible ESDT token.
Parameters
identifierstringrequiredpathToken identifier (ticker + random suffix)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get transactions for a specific token
Retrieves a paginated list of all transactions (including transfers, swaps, and multi‑token transfers) that involve the given fungible ESDT token. Each transaction entry includes hash, gas, status, timestamp, and a structured action field describing the operation.
Parameters
identifierstringrequiredpathToken identifier (ticker + random suffix)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get transaction count for a specific token
Counts all transactions (transfers, swaps, multi‑transfers) that involve the given fungible ESDT token.
Parameters
identifierstringrequiredpathToken identifier (ticker + random suffix)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get transfer events for a specific token
Retrieves a paginated list of transfer events (regular transactions and SmartContractResult objects) that involve the given fungible ESDT token. Each entry includes sender, receiver, status, timestamp, and structured action data.
Parameters
identifierstringrequiredpathToken identifier (ticker + random suffix)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get transfer event count for a specific token
Counts all transfer events (regular transactions and SmartContractResult objects) that involve the given fungible ESDT token.
Parameters
identifierstringrequiredpathToken identifier (ticker + random suffix)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get token logo as PNG image
Retrieves the PNG logo image associated with the given token identifier. The response is the raw PNG image data.
Parameters
identifierstringrequiredpathToken identifier (ticker + random suffix)
Response
Successful response – PNG image
Authorization
apiKeyapiKey in headerAPI key for authentication
Get token logo as SVG image
Retrieves the SVG logo image associated with the given token identifier. The response is the raw SVG data.
Parameters
identifierstringrequiredpathToken identifier (ticker + random suffix)
Response
Successful response – SVG image
Authorization
apiKeyapiKey in headerAPI key for authentication
Transactions
Get transactions
Retrieves a paginated list of transactions from the network. Each transaction entry includes metadata, gas information, status, timestamp, and a structured action field (for token transfers or smart contract calls). The response can be filtered by various query parameters (e.g., sender, receiver, function) depending on implementation.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get total number of transactions
Counts all transactions (including smart contract calls, transfers, and system operations) across the entire network.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get transaction by hash
Retrieves full details of a specific transaction, including its hash, gas, status, sender/receiver assets, action, results (internal transactions), and event logs.
Parameters
txHashstringrequiredpathTransaction hash (hexadecimal string)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Usernames
Get account by username
Looks up an account using its human‑readable username (e.g., "alice.elrond" or the HEX representation). Returns the same account information as the /accounts/{address} endpoint, including balance, nonce, shard, root hash, and the resolved username.
Parameters
usernamestringrequiredpathHuman‑readable username (e.g., "alice.elrond") or its HEX representation
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Waiting-list
Get waiting list entries
Retrieves the list of addresses that are currently in the waiting queue for validator staking, along with their rank, nonce, and staked value.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get waiting list entry count
Counts all addresses currently in the waiting queue for validator staking.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Default
Batch request for account data
Fetches a collection of related data for a given account in one request. This endpoint is useful for reducing the number of round trips. The exact response structure depends on the implementation, typically returning aggregated information such as balance, tokens, transactions summary, etc.
Parameters
addressstringrequiredpathAccount address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Dapp/config
Get dApp configuration
Retrieves the configuration object used by decentralised applications (dApps) to connect to the MultiversX network. Includes network identifiers, chain ID, API endpoints, wallet addresses, and WalletConnect bridge settings.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Websocket
Get WebSocket configuration
Retrieves the WebSocket server URL that provides real‑time updates (e.g., transactions, blocks, events). Clients can connect to this URL to receive live data streams.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Transfers
Get transfer events
Retrieves a paginated list of transfer events (regular transactions and SmartContractResult objects) that involve EGLD or ESDT token movements. Each entry includes sender/receiver, status, value, timestamp, and optional structured action data.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get total number of transfer events
Counts all transfer events (regular transactions and SmartContractResult objects) across the entire network.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Applications
Get smart contract applications
Retrieves a paginated list of smart contract applications deployed on the network. Each entry includes the contract address, deployer, owner, code hash, deployment timestamp, current balance, and optional asset metadata.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get application details by address
Retrieves detailed information about a single smart contract, including its deployer, owner, code hash, deployment timestamp, current balance, transaction count, and optional asset metadata.
Parameters
addressstringrequiredpathSmart contract address in bech32 format
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Events
Get log events
Retrieves a paginated list of event logs generated by smart contracts (e.g., ESDT transfers, swaps, claims). Each event includes the transaction hash, log address, event identifier, topics, data, and timestamp.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get total number of events
Counts all log events generated by smart contracts (e.g., transfers, swaps, claims) across the entire network.
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
Get event details by ID
Retrieves a single log event identified by its composite ID (transaction hash + index). The event contains the contract address, event identifier, topics, data, and metadata about its occurrence.
Parameters
eventIdstringrequiredpathEvent identifier (transaction hash with suffix, e.g., -1-3 for event index within the transaction)
Response
Successful response
Authorization
apiKeyapiKey in headerAPI key for authentication
REST-API
about
Returns the proxy's version and commit hash
Response
Successful operation
Authorization
apiKeyapiKey in headerAPI key for authentication
Returns the app versions of the nodes behind the proxy
Response
Successful operation
Authorization
apiKeyapiKey in headerAPI key for authentication
address
Returns data about an address
Parameters
addressstringrequiredpathThe address in bech32 format
Response
Successful operation
Authorization
apiKeyapiKey in headerAPI key for authentication
Returns the balance of the provided address in string format
Parameters
addressstringrequiredpathThe address in bech32 format
Response
Successful operation
Authorization
apiKeyapiKey in headerAPI key for authentication
Returns the nonce of the provided address
Parameters
addressstringrequiredpathThe address in bech32 format
Response
Successful operation
Authorization
apiKeyapiKey in headerAPI key for authentication
Returns the username of the provided address
Parameters
addressstringrequiredpathThe address in bech32 format
Response
Successful operation
Authorization
apiKeyapiKey in headerAPI key for authentication
Returns the shard ID of the provided address
Parameters
addressstringrequiredpathThe address in bech32 format
Response
Successful operation
Authorization
apiKeyapiKey in headerAPI key for authentication
Returns the value of the provided key for an address
Parameters
addressstringrequiredpathThe address in bech32 format
keystringrequiredpathStorage key to retrieve
Response
Successful operation
Authorization
apiKeyapiKey in headerAPI key for authentication
Returns all ESDT tokens that the provided address interacted with
Parameters
addressstringrequiredpathThe address in bech32 format
Response
Successful operation
Authorization
apiKeyapiKey in headerAPI key for authentication
Returns ESDT token data for the provided address and token identifier
Parameters
addressstringrequiredpathThe address in bech32 format
tokenIdentifierstringrequiredpathThe token identifier to search for
Response
Successful operation
Authorization
apiKeyapiKey in headerAPI key for authentication
network
Returns the configuration of the network
Response
Successful operation
Authorization
apiKeyapiKey in headerAPI key for authentication
Returns the economics data metric from the last epoch
Response
Successful operation
Authorization
apiKeyapiKey in headerAPI key for authentication
transaction
Sends a transaction to the network
Body
nonceintegerrequiredTransaction nonce
valuestringrequiredTransaction value in wei
receiverstringrequiredReceiver address in bech32 format
senderstringrequiredSender address in bech32 format
gasPriceintegerrequiredGas price
gasLimitintegerrequiredGas limit
datastringTransaction data (base64 encoded)
chainIDstringrequiredNetwork chain identifier
versionintegerrequiredTransaction version
signaturestringrequiredTransaction signature
Response
Successful operation
Validation error
Authorization
apiKeyapiKey in headerAPI key for authentication
Returns the transaction which corresponds to the hash
Parameters
txhashstringrequiredpathThe transaction hash to search for
Response
Successful operation
Authorization
apiKeyapiKey in headerAPI key for authentication
Returns the status of the transaction which corresponds to the hash
Parameters
txhashstringrequiredpathThe transaction hash to search for
Response
Successful operation
Authorization
apiKeyapiKey in headerAPI key for authentication
block
Returns a block by nonce and shard
Parameters
shardintegerrequiredpathThe shard ID to look after
nonceintegerrequiredpathThe block nonce to look after
Response
Successful operation
Authorization
apiKeyapiKey in headerAPI key for authentication
hyperblock
Gets the hyperblock at the specified nonce
Parameters
nonceintegerrequiredpathThe nonce to look after
Response
Successful operation
Authorization
apiKeyapiKey in headerAPI key for authentication
vm-values
Sends a request to the virtual machines and retrieves the result including altered accounts
Body
scAddressstringSmart contract address
funcNamestringFunction name to call
callerAddrstringCaller address
callValuestringValue to send with the call
argsArray<string>Function arguments
Response
Successful operation
Authorization
apiKeyapiKey in headerAPI key for authentication