Recipe logo

Fantom Network

Introduction

Fantom is a fast, high-throughput open-source smart contract platform for digital assets and dApps.

Founded in 2018, Fantom is designed to overcome the limitations of previous-generation blockchain platforms. Fantom is permissionless, decentralized, and open-source while achieving fast finality (1-2 second transaction confirmation) and low fees ($0.00001). Furthermore, Fantom is EVM-compatible.

Fantom code is completely open source. Anyone can read it, check on the progress, comment on it, and contribute. Fantom integrates industry-leaders oracle providers Chainlink and Band Protocol for maximum flexibility to access price feeds.

Quick facts

Property Value
Network name Fantom Opera
Mainnet chainId 250
Testnet chainId 4002
Famtom Block Explorer https://ftmscan.com/
Block time ~2 seconds

Supported endpoints

Get token balances for address
Class A
Given chain_id and wallet address, return current token balances along with their spot prices. This endpoint supports a variety of token standards like ERC20, ERC721 and ERC1155. As a special case, network native tokens like ETH on Ethereum are also returned even though it’s not a token contract.
GET
/v1/:chain_id/address/:address/balances_v2/
Get transactions for address
Class A
Given chain_id and wallet address, return all transactions along with their decoded log events. This endpoint does a deep-crawl of the blockchain to retrieve all kinds of transactions that references the address including indexed topics within the event logs.
GET
/v1/:chain_id/address/:address/transactions_v2/
Get ERC20 token transfers for address
Class A
Given chain_id, wallet address and contract-address, return all ERC20 token contract transfers along with their historical prices at the time of their transfer.
GET
/v1/:chain_id/address/:address/transfers_v2/
Get token holders as of any block height
Class A
Given chain_id and wallet address, return a paginated list of token holders. If block-height is omitted, the latest block is used.
GET
/v1/:chain_id/tokens/:address/token_holders/
Get log events by contract address
Class A
Given chain_id and contract address, return a paginated list of decoded log events emitted by a particular smart contract.
GET
/v1/:chain_id/events/address/:address/
Get log events by topic hash(es)
Class A
Given chain_id and topic hash(es), return a paginated list of decoded log events with one or more topic hashes separated by a comma.
GET
/v1/:chain_id/events/topics/:topic/

Go to Covalent’s API Reference

Appendix

Fantom token

The Fantom token FTM is the native token of Fantom. This is similar to Ether in Ethereum. To interact with the Fantom network, FTM tokens are required to pay 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 Fantom-Opera chain. These addresses are used to reverse-lookup prices on Fantom and also to return the right token logo urls.

Some example of mapped tokens:

Token Ethereum mainnet Fantom mainnet
USDT 0xdac17f958d2ee523a2206206994597c13d831ec7 0x1ffbd1e3584f139ca42d77ef99ef99550ecf46a8
YFI 0x0bc529c00C6401aEF6D220BE8C6Ea1667F6Ad93e 0xc396b190f251d7f79c583fd06347a09781f085c9

For the current token mapping list, see: https://netapi.anyswap.net/bridge/v2/info

Token prices

For tokens that have a mapping back to Ethereum mainnet, the Covalent API is able to return the mapped prices.

Infrastructure Providers

The following provide infrastructure for this blockchain network:

Last modified: September 21, 2022: Update postman collection URL (5744f29)