Wallet Portfolio Tracker API

io.github.Br0ski777Published by GitHub account Br0ski777v1.1.0Updated Oct 24, 2026

Crypto wallet balances, ERC-20 tokens, USD values across Base and Ethereum. x402.

The publisher's own server: PortfolioFit

VerifiedSSEWeb executableDatabases Finance

Server details

Identifier: io.github.Br0ski777/wallet-portfolio
Transport: SSE
Runtime: Web executable
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account Br0ski777 for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.Br0ski777%2Fwallet-portfolio.svg)](https://sourceweft.com/mcp/io.github.Br0ski777%2Fwallet-portfolio?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Remote MCP endpoint that lets an assistant look up crypto wallet holdings — ETH, ERC-20 tokens and USD values on Base and Ethereum — with each call paid in USDC

What you can do: Read a full wallet portfolio: native ETH balance, ERC-20 token list with symbols, balances, USD values and contract addresses, plus a total USD value, for a given address and chain (default Base).
When to use it: Use it when an assistant needs to check what a wallet holds before a swap or trade, track a portfolio, or report balances. The lighter balance tool suits quick ETH and USDC checks where the full token list is not needed. It does not cover gas prices, swap quotes or yield opportunities. It is not for gas prices, swap quotes or yield opportunities. It is not for gas prices, swap quotes or yield opportunities. It is not for gas prices, swap quotes or yield opportunities. It is not for gas prices, a
Requirements: Remote SSE endpoint; no local runtime, account or API key. An x402-capable client with a funded USDC wallet on Base L2 is needed to pay each call, and network access to the provider.

Before you install

Every tool call is paid: $0.008 for the portfolio tool and $0.003 for the balance tool, settled in USDC on Base L2 through x402, so an assistant can spend real funds without a signup or API key. The client must be able to sign the 402 payment challenge, which means a funded wallet is involved. Wallet addresses you query are sent to a third-party service.

Installation

In SourceWeft

Open Wallet Portfolio Tracker API in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via SSE. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Br0ski777%2Fwallet-portfolio/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Wallet Portfolio Tracker API

[MCP Server] [x402] [License: MIT]

Full crypto wallet holdings across chains -- ETH, ERC-20 tokens, USD values. Portfolio tracking for agents. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.

Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.

Quickstart -- MCP

Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):

json

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

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

Quickstart -- HTTP (x402)

bash

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

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

Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.

Tools

Tool	Method	Path	Price	Description
`wallet_get_portfolio`	GET	`/api/portfolio`	$0.008	Get full portfolio with all token balances and USD values
`wallet_get_portfolio`	POST	`/api/portfolio`	$0.008	Get full portfolio with all token balances and USD values (POST variant)
`wallet_get_balance`	GET	`/api/balance`	$0.003	Get ETH and USDC balance only
`wallet_get_balance`	POST	`/api/balance`	$0.003	Get ETH and USDC balance only (POST variant)

`wallet_get_portfolio`

Use this when you need to check a crypto wallet's holdings across chains. Returns a full portfolio breakdown in JSON.

Parameters

Returns

nativeBalance -- ETH balance with USD value
tokens -- array of ERC-20 tokens with symbol, balance, USD value, contract address
totalValueUsd -- aggregate portfolio value in USD
chain -- which network was queried

Example response:

json

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

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

When to use: executing a swap to verify the wallet has sufficient balance. Essential for portfolio tracking, balance checks, and agent self-reporting.

Not for: gas prices (use gas_get_current_price), swap quotes (use dex_get_swap_quote), yield opportunities (use defi_find_best_yields).

`wallet_get_portfolio`

Use this when you need to check a crypto wallet's holdings across chains. Returns a full portfolio breakdown in JSON.

Parameters

Returns

nativeBalance -- ETH balance with USD value
tokens -- array of ERC-20 tokens with symbol, balance, USD value, contract address
totalValueUsd -- aggregate portfolio value in USD
chain -- which network was queried

Example response:

json

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

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

When to use: executing a swap to verify the wallet has sufficient balance. Essential for portfolio tracking, balance checks, and agent self-reporting.

Not for: gas prices (use gas_get_current_price), swap quotes (use dex_get_swap_quote), yield opportunities (use defi_find_best_yields).

`wallet_get_balance`

Use this when you need a quick check of a wallet's ETH and USDC balance only. Returns a lightweight JSON response -- cheaper than full portfolio.

Parameters

Returns

ethBalance -- native ETH balance with USD value
usdcBalance -- USDC balance with USD value
chain -- which network was queried

Example response:

json

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

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

When to use: quick pre-trade balance verification when you only care about ETH and USDC. Faster and cheaper than wallet_get_portfolio.

Not for: full portfolio with all tokens (use wallet_get_portfolio), gas prices (use gas_get_current_price).

`wallet_get_balance`

Use this when you need a quick check of a wallet's ETH and USDC balance only. Returns a lightweight JSON response -- cheaper than full portfolio.

Parameters

Returns

ethBalance -- native ETH balance with USD value
usdcBalance -- USDC balance with USD value
chain -- which network was queried

Example response:

json

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

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

When to use: quick pre-trade balance verification when you only care about ETH and USDC. Faster and cheaper than wallet_get_portfolio.

Not for: full portfolio with all tokens (use wallet_get_portfolio), gas prices (use gas_get_current_price).

Example agent prompts

"Check a crypto wallet's holdings across chains"
"Check a crypto wallet's holdings across chains"
"A quick check of a wallet's ETH and USDC balance only"

Payment

Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key
Network: Base L2 (eip155:8453)
Asset: USDC
Facilitator: Coinbase CDP (primary), PayAI (fallback)
Also reachable via ATXP (OAuth-wrapped x402, RFC 9728 protected-resource metadata)

Part of klymax402

100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.

Catalog: https://klymax402.com/llms.txt
Full API reference: https://klymax402.com/llms-full.txt
Live stats: https://klymax402.com/stats

License

MIT

Source: README.md at commit fd7b05c

Tools

SourceWeft has not read this server's tools yet.

Version history

v1.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declaredRequired10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

Other Portfolio integrations

PortfolioFit

fit.portfolioOfficial publisher

PortfolioFit is a remote MCP server that lets an assistant check normalized portfolios against mandates and compute allocation constraints and statistics.

Streamable HTTPWeb executable

Finance10 toolsOct 24, 2026

Cameron Rye Portfolio MCP Server

dev.ryeOfficial publisher

Remote MCP endpoint exposing Cameron Rye's blog, portfolio projects, bio, reading list and live site stats, plus contact and newsletter tools.

Streamable HTTPWeb executable

Knowledge & Memory12 toolsOct 24, 2026

Shlok Bam's portfolio

Published by GitHub account shlokbam

Shlok Bam's portfolio's hosted MCP server; no sign-in required; Streamable HTTP; 10 tools.

Streamable HTTPWeb executable

Finance10 toolsNov 3, 2026

Harshith Nayaka L portfolio docs

Published by GitHub account HarshithNayakaL

Read-only MCP server exposing the developer documentation for a portfolio site's JSON API, MCP, A2A and NLWeb endpoints.

Streamable HTTPWeb executable

Knowledge & Memory3 toolsOct 30, 2026

Harshith Nayaka L portfolio

Published by GitHub account HarshithNayakaL

Read-only MCP access to Harshith Nayaka L's portfolio site, letting an assistant look up his profile, projects, case studies, FAQ and agent skills.

Streamable HTTPWeb executable

Web Search & Scraping6 toolsOct 30, 2026

Name	Type	Required	Description
`address`	string	yes	Wallet address (0x...)
`chain`	string	no	Blockchain network (default: base)

Name	Type	Required	Description
`address`	string	yes	Wallet address (0x...)
`chain`	string	no	Blockchain network (default: base)

Name	Type	Required	Description
`address`	string	yes	Wallet address (0x...)
`chain`	string	no	Blockchain network (default: base)

Name	Type	Required	Description
`address`	string	yes	Wallet address (0x...)
`chain`	string	no	Blockchain network (default: base)