지갑 포트폴리오 추적기 API

체인 전반의 전체 암호화폐 지갑 보유 내역 -- ETH, ERC-20 토큰, USD 가치. 에이전트를 위한 포트폴리오 추적. x402를 통한 호출당 결제 (Base L2의 USDC) -- API 키 없음, 가입 없음, 요금 제한 벽 없음.

klymax402 마켓플레이스의 일부 -- AI 에이전트를 위한 100개의 x402 마이크로결제 API, 하나의 지갑, Base의 USDC.

빠른 시작 -- MCP

MCP 클라이언트 구성에 추가하세요 (Claude Desktop, Cursor, ElizaOS 등):

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

Related MCP server: AgentWallet MCP Server

빠른 시작 -- 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

암호화폐 지갑의 체인 전반 보유 내역을 확인해야 할 때 사용하세요. JSON으로 전체 포트폴리오 분석을 반환합니다.

매개변수

반환 값

• nativeBalance -- USD 가치가 포함된 ETH 잔액

• tokens -- 심볼, 잔액, USD 가치, 계약 주소가 포함된 ERC-20 토큰 배열

• 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으로 전체 포트폴리오 분석을 반환합니다.

매개변수

반환 값

• nativeBalance -- USD 가치가 포함된 ETH 잔액

• tokens -- 심볼, 잔액, USD 가치, 계약 주소가 포함된 ERC-20 토큰 배열

• 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 응답을 반환합니다 -- 전체 포트폴리오보다 저렴합니다.

매개변수

반환 값

• ethBalance -- USD 가치가 포함된 기본 ETH 잔액

• usdcBalance -- USD 가치가 포함된 USDC 잔액

• 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 응답을 반환합니다 -- 전체 포트폴리오보다 저렴합니다.

매개변수

반환 값

• ethBalance -- USD 가치가 포함된 기본 ETH 잔액

• usdcBalance -- USD 가치가 포함된 USDC 잔액

• 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를 통해서도 접근 가능 (OAuth로 래핑된 x402, RFC 9728 보호 리소스 메타데이터)

klymax402의 일부

AI 에이전트를 위한 100개의 x402 마이크로결제 API -- 하나의 지갑, Base의 USDC, 가입 없음.

• 카탈로그: https://klymax402.com/llms.txt

• 전체 API 참조: https://klymax402.com/llms-full.txt

• 실시간 통계: https://klymax402.com/stats

라이선스

MIT