Wallet Portfolio Tracker API

Tenencias completas de carteras de criptomonedas en varias cadenas -- ETH, tokens ERC-20, valores en USD. Seguimiento de carteras para agentes. Pago por llamada a través de x402 (USDC en Base L2) -- sin clave API, sin registro, sin muro de límite de peticiones.

Parte del mercado klymax402 -- 100 APIs de micropagos x402 para agentes de IA, una cartera, USDC en Base.

Inicio rápido -- MCP

Añade a la configuración de tu cliente MCP (Claude Desktop, Cursor, ElizaOS, etc.):

{
  "mcpServers": {
    "wallet-portfolio": {
      "url": "https://wallet-portfolio.api.klymax402.com/mcp"
    }
  }
}

Related MCP server: chain-data

Inicio rápido -- HTTP (x402)

curl "https://wallet-portfolio.api.klymax402.com/api/portfolio?address=0x0000000000000000000000000000000000dEaD"
# -> 402 Payment Required, with an x402 payment challenge in the response body

Cualquier cliente compatible con x402 (@x402/fetch, x402-agent-tools, ATXP) maneja el ciclo 402 -> firma -> reintento automáticamente.

Herramientas

wallet_get_portfolio

Úsalo cuando necesites comprobar las tenencias de una cartera de criptomonedas en varias cadenas. Devuelve un desglose completo de la cartera en JSON.

Parámetros

Devuelve

• nativeBalance -- saldo de ETH con valor en USD

• tokens -- array de tokens ERC-20 con símbolo, saldo, valor en USD, dirección del contrato

• totalValueUsd -- valor agregado de la cartera en USD

• chain -- qué red se consultó

Ejemplo de respuesta:

{"nativeBalance":{"symbol":"ETH","balance":"1.234","valueUsd":3827.50},"tokens":[{"symbol":"USDC","balance":"500.00","valueUsd":500.00}],"totalValueUsd":4327.50,"chain":"base"}

Cuándo usarlo: ejecutar un swap para verificar que la cartera tiene saldo suficiente. Esencial para el seguimiento de carteras, comprobaciones de saldo y autoinforme de agentes.

No para: precios de gas (usa gas_get_current_price), cotizaciones de swap (usa dex_get_swap_quote), oportunidades de rendimiento (usa defi_find_best_yields).

wallet_get_portfolio

Úsalo cuando necesites comprobar las tenencias de una cartera de criptomonedas en varias cadenas. Devuelve un desglose completo de la cartera en JSON.

Parámetros

Devuelve

• nativeBalance -- saldo de ETH con valor en USD

• tokens -- array de tokens ERC-20 con símbolo, saldo, valor en USD, dirección del contrato

• totalValueUsd -- valor agregado de la cartera en USD

• chain -- qué red se consultó

Ejemplo de respuesta:

{"nativeBalance":{"symbol":"ETH","balance":"1.234","valueUsd":3827.50},"tokens":[{"symbol":"USDC","balance":"500.00","valueUsd":500.00}],"totalValueUsd":4327.50,"chain":"base"}

Cuándo usarlo: ejecutar un swap para verificar que la cartera tiene saldo suficiente. Esencial para el seguimiento de carteras, comprobaciones de saldo y autoinforme de agentes.

No para: precios de gas (usa gas_get_current_price), cotizaciones de swap (usa dex_get_swap_quote), oportunidades de rendimiento (usa defi_find_best_yields).

wallet_get_balance

Úsalo cuando necesites una comprobación rápida del saldo de ETH y USDC de una cartera. Devuelve una respuesta JSON ligera -- más barata que la cartera completa.

Parámetros

Devuelve

• ethBalance -- saldo nativo de ETH con valor en USD

• usdcBalance -- saldo de USDC con valor en USD

• chain -- qué red se consultó

Ejemplo de respuesta:

{"ethBalance":{"balance":"2.5","valueUsd":7750.00},"usdcBalance":{"balance":"1000.00","valueUsd":1000.00},"chain":"base"}

Cuándo usarlo: verificación rápida de saldo previa a la operación cuando solo te interesan ETH y USDC. Más rápido y barato que wallet_get_portfolio.

No para: cartera completa con todos los tokens (usa wallet_get_portfolio), precios de gas (usa gas_get_current_price).

wallet_get_balance

Úsalo cuando necesites una comprobación rápida del saldo de ETH y USDC de una cartera. Devuelve una respuesta JSON ligera -- más barata que la cartera completa.

Parámetros

Devuelve

• ethBalance -- saldo nativo de ETH con valor en USD

• usdcBalance -- saldo de USDC con valor en USD

• chain -- qué red se consultó

Ejemplo de respuesta:

{"ethBalance":{"balance":"2.5","valueUsd":7750.00},"usdcBalance":{"balance":"1000.00","valueUsd":1000.00},"chain":"base"}

Cuándo usarlo: verificación rápida de saldo previa a la operación cuando solo te interesan ETH y USDC. Más rápido y barato que wallet_get_portfolio.

No para: cartera completa con todos los tokens (usa wallet_get_portfolio), precios de gas (usa gas_get_current_price).

Ejemplos de prompts de agente

• "Comprobar las tenencias de una cartera de criptomonedas en varias cadenas"

• "Comprobar las tenencias de una cartera de criptomonedas en varias cadenas"

• "Una comprobación rápida del saldo de ETH y USDC de una cartera"

Pago

• Protocolo: x402 -- pago por llamada nativo de HTTP, sin registro, sin clave API

• Red: Base L2 (eip155:8453)

• Activo: USDC

• Facilitador: Coinbase CDP (principal), PayAI (respaldo)

• También accesible a través de ATXP (x402 envuelto en OAuth, metadatos de recurso protegido RFC 9728)

Parte de klymax402

100 APIs de micropagos x402 para agentes de IA -- una cartera, USDC en Base, cero registro.

• Catálogo: https://klymax402.com/llms.txt

• Referencia completa de la API: https://klymax402.com/llms-full.txt

• Estadísticas en vivo: https://klymax402.com/stats

Licencia

MIT