Documentación de la API

Introducción

Esta API te permite consultar datos de diferentes blockchains, centrándose en la información de tokens y transferencias. Actualmente soportamos las redes Base Mainnet y Base Testnet.

Endpoints

GET /api/tokens/transfers

Obtiene las transferencias de tokens para una dirección de wallet específica.

Parámetros

  • wallet - Dirección de la wallet a consultar (requerido)
  • network - Red blockchain a utilizar ('base' o 'base-testnet') (opcional, por defecto: 'base')
  • token - Filtro para tokens específicos (dirección o símbolo) (opcional)

Ejemplo de respuesta

[
  {
    "tokenAddress": "0x4200000000000000000000000000000000000006",
    "tokenSymbol": "WETH",
    "tokenName": "Wrapped Ether",
    "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "to": "0x123...abc",
    "amount": "0.5",
    "timestamp": 1679012345,
    "transactionHash": "0x1234...abcd"
  },
  {
    "tokenAddress": "0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca",
    "tokenSymbol": "USDbC",
    "tokenName": "USD Base Coin",
    "from": "0x123...def",
    "to": "0x123...abc",
    "amount": "100",
    "timestamp": 1679012345,
    "transactionHash": "0xabcd...1234"
  }
]

GET /api/tokens/balance

Obtiene el balance de tokens para una dirección de wallet específica.

Parámetros

  • wallet - Dirección de la wallet a consultar (requerido)
  • network - Red blockchain a utilizar ('base' o 'base-testnet') (opcional, por defecto: 'base')

Ejemplo de respuesta

[
  {
    "tokenAddress": "0x4200000000000000000000000000000000000006",
    "tokenSymbol": "WETH",
    "tokenName": "Wrapped Ether",
    "balance": "1.5",
    "decimals": 18,
    "usdValue": 3000
  },
  {
    "tokenAddress": "0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca",
    "tokenSymbol": "USDbC",
    "tokenName": "USD Base Coin",
    "balance": "250",
    "decimals": 6,
    "usdValue": 250
  }
]

Implementación

Para implementar estas APIs en tu proyecto, puedes crear rutas API en Next.js que utilicen la biblioteca ethers.js para interactuar con las blockchains.

Probar el Explorador