Skip to main content
Glama
Br0ski777

wallet-portfolio

by Br0ski777

Wallet Portfolio Tracker API

MCP Server x402 License: MIT

Полные данные о криптовалютных активах кошелька в разных сетях — ETH, токены ERC-20, стоимость в USD. Отслеживание портфеля для агентов. Оплата за вызов через x402 (USDC на Base L2) — без API-ключа, без регистрации, без ограничений по частоте запросов.

Часть маркетплейса klymax402 — 100 x402 микроплатежных API для AI-агентов, один кошелек, USDC на Base.

Быстрый старт -- MCP

Добавьте в конфигурацию вашего MCP-клиента (Claude Desktop, Cursor, ElizaOS и т.д.):

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

Related MCP server: chain-data

Быстрый старт -- 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

Любой клиент, поддерживающий x402 (@x402/fetch, x402-agent-tools, ATXP), автоматически обрабатывает цикл 402 -> подпись -> повторная попытка.

Инструменты

Инструмент

Метод

Путь

Цена

Описание

wallet_get_portfolio

GET

/api/portfolio

$0.008

Получить полный портфель со всеми балансами токенов и стоимостью в USD

wallet_get_portfolio

POST

/api/portfolio

$0.008

Получить полный портфель со всеми балансами токенов и стоимостью в USD (вариант POST)

wallet_get_balance

GET

/api/balance

$0.003

Получить только баланс ETH и USDC

wallet_get_balance

POST

/api/balance

$0.003

Получить только баланс ETH и USDC (вариант POST)

wallet_get_portfolio

Используйте это, когда нужно проверить активы криптовалютного кошелька в разных сетях. Возвращает полную разбивку портфеля в JSON.

Параметры

Имя

Тип

Обязательный

Описание

address

string

да

Адрес кошелька (0x...)

chain

string

нет

Сеть блокчейна (по умолчанию: base)

Возвращает

  • nativeBalance — баланс ETH со стоимостью в USD

  • tokens — массив токенов ERC-20 с символом, балансом, стоимостью в USD и адресом контракта

  • totalValueUsd — общая стоимость портфеля в USD

  • chain — какая сеть была запрошена

Пример ответа:

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

Когда использовать: при выполнении свопа для проверки достаточного баланса кошелька. Необходимо для отслеживания портфеля, проверки баланса и самостоятельной отчетности агента.

Не для: цен на газ (используйте gas_get_current_price), котировок свопов (используйте dex_get_swap_quote), возможностей доходности (используйте defi_find_best_yields).

wallet_get_portfolio

Используйте это, когда нужно проверить активы криптовалютного кошелька в разных сетях. Возвращает полную разбивку портфеля в JSON.

Параметры

Имя

Тип

Обязательный

Описание

address

string

да

Адрес кошелька (0x...)

chain

string

нет

Сеть блокчейна (по умолчанию: base)

Возвращает

  • nativeBalance — баланс ETH со стоимостью в USD

  • tokens — массив токенов ERC-20 с символом, балансом, стоимостью в USD и адресом контракта

  • totalValueUsd — общая стоимость портфеля в USD

  • chain — какая сеть была запрошена

Пример ответа:

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

Когда использовать: при выполнении свопа для проверки достаточного баланса кошелька. Необходимо для отслеживания портфеля, проверки баланса и самостоятельной отчетности агента.

Не для: цен на газ (используйте gas_get_current_price), котировок свопов (используйте dex_get_swap_quote), возможностей доходности (используйте defi_find_best_yields).

wallet_get_balance

Используйте это, когда нужна быстрая проверка только баланса ETH и USDC кошелька. Возвращает легкий JSON-ответ — дешевле, чем полный портфель.

Параметры

Имя

Тип

Обязательный

Описание

address

string

да

Адрес кошелька (0x...)

chain

string

нет

Сеть блокчейна (по умолчанию: base)

Возвращает

  • ethBalance — баланс нативного ETH со стоимостью в USD

  • usdcBalance — баланс USDC со стоимостью в USD

  • chain — какая сеть была запрошена

Пример ответа:

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

Когда использовать: быстрая проверка баланса перед сделкой, когда вас интересуют только ETH и USDC. Быстрее и дешевле, чем wallet_get_portfolio.

Не для: полный портфель со всеми токенами (используйте wallet_get_portfolio), цены на газ (используйте gas_get_current_price).

wallet_get_balance

Используйте это, когда нужна быстрая проверка только баланса ETH и USDC кошелька. Возвращает легкий JSON-ответ — дешевле, чем полный портфель.

Параметры

Имя

Тип

Обязательный

Описание

address

string

да

Адрес кошелька (0x...)

chain

string

нет

Сеть блокчейна (по умолчанию: base)

Возвращает

  • ethBalance — баланс нативного ETH со стоимостью в USD

  • usdcBalance — баланс USDC со стоимостью в USD

  • chain — какая сеть была запрошена

Пример ответа:

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

Когда использовать: быстрая проверка баланса перед сделкой, когда вас интересуют только ETH и USDC. Быстрее и дешевле, чем wallet_get_portfolio.

Не для: полный портфель со всеми токенами (используйте wallet_get_portfolio), цены на газ (используйте gas_get_current_price).

Примеры промптов для агентов

  • "Проверить активы криптовалютного кошелька в разных сетях"

  • "Проверить активы криптовалютного кошелька в разных сетях"

  • "Быстрая проверка только баланса ETH и USDC кошелька"

Оплата

  • Протокол: x402 — нативный HTTP-оплата за вызов, без регистрации, без API-ключа

  • Сеть: Base L2 (eip155:8453)

  • Актив: USDC

  • Фасилитатор: Coinbase CDP (основной), PayAI (резервный)

  • Также доступен через ATXP (x402 с оберткой OAuth, метаданные защищенного ресурса RFC 9728)

Часть klymax402

100 x402 микроплатежных API для AI-агентов — один кошелек, USDC на Base, без регистрации.

Лицензия

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Enables AI agents to retrieve real-time data on wallet DeFi positions, token balances, and NFT holdings across multiple blockchains. It supports hundreds of protocols and provides specialized tools for chain-specific or protocol-specific portfolio analysis.
    8
    8 npm
    3
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Enables AI agents to fetch live multi-chain portfolio, token info, gas prices, and token prices across Ethereum, Base, Polygon, Arbitrum, and Optimism with a single call. No API key required.
    4
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Enables AI agents to access Solana wallet analytics, token data, and DeFi tools via pay-per-request USDC micropayments using the x402 protocol, without API keys or subscriptions.
    13
    34 npm
    MIT