Etherspot
These are our V1 docs and will be deprecated soon. Please visit https://etherspot.fyi/introduction to use our new version of the SDK.
  • Welcome to Etherspot
    • Chains, Bridges & DEXes
    • Social Logins
    • Web3 Logins
  • Transaction Kit
    • Introduction
    • Code Sandboxes
    • Quick Start
    • React Hooks
      • useEtherspotAssets()
      • useEtherspotNfts()
      • useEtherspotHistory()
        • getAccountTransactions()
        • getAccountTransaction()
      • useEtherspotTransactions()
        • estimate()
        • send()
      • useEtherspotAddresses()
      • useEtherspotBalances()
    • React Components
      • <EtherspotTransactionKit />
      • <EtherspotBatches />
      • <EtherspotBatch />
      • <EtherspotTransaction />
      • <EtherspotContractTransaction />
      • <EtherspotApprovalTransaction />
      • <EtherspotTokenTransferTransaction />
  • BUIDLER React Component
    • Introduction
    • Installation
    • Integrate React Component
    • Shared Sessions
    • Wallet Connectors
    • Blocks
      • Send
      • Batching Transaction
      • Multicall Transaction
      • Swaps
      • Bridges
      • Custom Contract Interactions
      • Styling
    • Build Your Own Block
      • Cross-chain KLIMA DAO Staking
  • Etherspot SDK Guides
    • Requirements
    • Install Etherspot SDK
    • Bootstrap Etherspot SDK
      • Instantiate Etherspot SDK
    • Events
    • Etherspot Block Explorer
    • Etherspot Playground
    • Social Login using Etherspot SDK
    • Sponsored Transactions
  • Use Cases & Guides
    • Crosschain Streaming
    • Token Swaps
    • Transactions
      • Historical
      • Sending
    • Multi-chain Bridges
      • ERC20 Bridge
      • DAI - xDai Bridge
      • xDai - DAI Bridge
      • Native Token Bridge
    • Custom Contract Interaction
    • Multi-chain Assets
    • Multi-chain Gas Prices
    • Peer-to-Peer Payments
  • Reference
    • Etherspot SDK API Docs
    • Etherspot SDK on Github
    • Etherspot on NPM
    • Etherspot Playground
    • Etherspot Block Explorer
    • Etherspot Architecture
    • EIP-1271
    • Etherspot/Pillar Audit
  • Brand Assets
    • Etherspot Brand Assets
  • Security
    • Security
  • Get in touch
    • ⚒️Discord
    • Twitter
    • Telegram
Powered by GitBook
On this page
  • Introduction
  • Ready-to-fork CodeSandbox available
  • How to use
  • Congratulations!

Was this helpful?

  1. Transaction Kit
  2. React Hooks

useEtherspotAssets()

A React hook that retuns a list of tokens for developers to use in their project.

PreviousReact HooksNextuseEtherspotNfts()

Last updated 2 years ago

Was this helpful?

Introduction

As part of any cryptocurrency related app, it's essential to be able to access a list of other cryptocurrencies and their asset data (such as asset logo) to use within your app, otherwise you'll likely need to try and find this yourself.

The useEtherspotAssets hook makes this easy for you by allowing you to access our prebuilt list of tokens for every chain.

Ready-to-fork CodeSandbox available

There is a CodeSandbox available for this hook. Check it out to see the useEtherspotAssets hook in action action, and fork it should you want to test or change anything.

How to use

import {
  useEtherspotAssets
} from "@etherspot/transaction-kit";

// Later in your component function...

const { getAssets } = useEtherspotAssets();

// When you're ready to fetch the assets...

const tokens = await getAssets();

// `tokens` will look similar to the following...

// [
//   {
//     "address": "0xe3818504c1B32bF1557b16C238B2E01Fd3149C17",
//     "chainId": 1,
//     "decimals": 18,
//     "logoURI": "https://images.prismic.io/pillar-app/83dcf8ff-6459-41d4-8d43-7ec143814b2d_pillar-logo-5.png?auto=compress,format",
//     "name": "Pillar",
//     "symbol": "PLR"
//   },
//   {
//     "address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
//     "chainId": 1,
//     "decimals": 6,
//     "logoURI": "https://raw.githubusercontent.com/bnb-chain/tokens-info-v2/master/tokens/usdt/usdt.png",
//     "name": "USDT",
//     "symbol": "USDT"
//   },
//   ...  
// ]

Now you know how to fetch a list of popular assets to use in your app instead of having to find a data source of tokens from somewhere else.

Congratulations!

🎉
👉
CodeSandbox directory: Etherspot Assets