Binance Smart Chain
Introduction
Binance Smart Chain (BSC) is best described as a blockchain that runs in parallel to the Binance Chain. Unlike Binance Chain, BSC boasts smart contract functionality and compatibility with the Ethereum Virtual Machine (EVM). The design goal here was to leave the high throughput of Binance Chain intact while introducing smart contracts into its ecosystem.
Quick facts
Property | Value |
---|---|
BSC Mainnet chainId | 56 |
BSC Blockchain Explorer | https://bscscan.com/ |
Block time | ~5 seconds |
Supported endpoints
api.covalenthq.com/v1/{chainId}/address/{address}/balances_v2/
- Get token balances for
address
. Return a list of all ERC20 and NFT token balances including ERC721 and ERC1155 along with their current spot prices.
- Get token balances for
api.covalenthq.com/v1/{chainId}/address/{address}/transactions_v2/
- Retrieve all transactions for
address
including their decoded log events. This endpoint does a deep-crawl of the blockchain to retrieve all kinds of transactions that references the address.
- Retrieve all transactions for
api.covalenthq.com/v1/{chainId}/address/{address}/transfers_v2/
- Get ERC20 token transfers for
address
alongwith historical token prices.
- Get ERC20 token transfers for
api.covalenthq.com/v1/{chainId}/tokens/{contract_address}/token_holders/
- Return a paginated list of token holders
contract_address
as of any historical block height.
- Return a paginated list of token holders
api.covalenthq.com/v1/{chainId}/events/address/{contract_address}/
- Return a paginated list of decoded log events emitted by a particular smart contract.
api.covalenthq.com/v1/{chainId}/events/topics/{topic}/
- Return a paginated list of decoded log events with one or more topic hashes separated by a comma.
Appendix
BNB Gas token
The BNB token is the native token of the BSC network. This is similar to Ether in Ethereum. To interact with the BSC network, BNB tokens are required to pay as gas fees. The Covalent API response returns gas_*
fields in fiat units.
Token mapping
Covalent maintains an on-chain real-time mapping of token addresses between Ethereum mainnet and the BSC chain. These addresses are used to reverse-lookup prices on BSC and also to return the right token logo urls.
Some example of mapped tokens:
Token | Ethereum mainnet | BSC mainnet |
---|---|---|
USDT | 0xdac17f958d2ee523a2206206994597c13d831ec7 | 0x55d398326f99059ff775485246999027b3197955 |
BAND | 0xba11d00c5f74255f56a5e366f4f77f5a186d7f55 | 0xad6caeb32cd2c308980a548bd0bc5aa4306c6c18 |
Token prices
For tokens that have a mapping back to Ethereum mainnet, Covalent is able to return the mapped prices.