Yield.xyz MCP · Yields GET Balances

by Yield.xyz MCP

POSTBaseX Layer

$0.001

per call · USD Coin on Base

Get live DeFi yield balances and pending actions for any wallet — active staking, lending, vault, and RWA positions with accrued rewards, USD values, current APY, and claimable actions. Covers 3,300+ yields (Lido, Aave, Morpho, tokenized treasuries) across 80+ networks. Call before actions_exit or actions_manage.

Endpoint

POST https://mcp.yield.xyz/x402/yields_get_balances

6

Calls / 30d

3

Unique payers / 30d

Sep 8

Last called

exact

Payment scheme

Call this service

TypeScript · @x402/fetch
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://mcp.yield.xyz/x402/yields_get_balances", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "network": "base"
  }),
});
const data = await res.json();
cURL
curl -X POST \
  "https://mcp.yield.xyz/x402/yields_get_balances" \
  -H "Content-Type: application/json" \
  -d '{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","network":"base"}' \
  -H "X-PAYMENT: <signed x402 payment>"

Example response

{
  "errors": [],
  "items": [
    {
      "balances": [
        {
          "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
          "amount": "0.300521",
          "amountUsd": "0.300435",
          "isEarning": true,
          "pendingActions": [
            {
              "intent": "manage",
              "passthrough": "eyJhZGRy…",
              "type": "UNSTAKE"
            }
          ],
          "token": {
            "decimals": 6,
            "name": "USD Coin",
            "network": "base",
            "symbol": "USDC"
          },
          "type": "active"
        }
      ],
      "yieldId": "base-usdc-dinari-usd-plus-vault"
    }
  ]
}

Payment details

Pay to0xd433f056270912659f073d5ffe7ae247e39235a5
AssetUSD Coin · 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913
NetworksBase, X Layer
Schemesexact

Is this your API?

Pin it to the top of DeFi and the homepage with a featured placement.

Get featured →

More from Yield.xyz MCP & similar services

Yield.xyz MCP · Yields GET ALL

mcp.yield.xyz

Discover DeFi yield opportunities across 80+ networks — 3,300+ staking, lending, vault, and RWA yields from Lido, Aave, Morpho, and more. Filter by token, network, yield type, or provider and sort by APY or TVL. Returns yield IDs (needed by every other tool) with APY, TVL, lock-up/cooldown periods, and KYC gating. Start here.

POSTBaseDeFi
$0.001 / call13 calls / 30d

Yield.xyz MCP · Networks GET ALL

mcp.yield.xyz

List every network Yield.xyz supports (80+) with its id (slug), name, and category (EVM, Cosmos, Substrate, misc). Filter by name/id or category. Use the network id to filter yields_get_all.

POSTBaseOnchain Data
$0.001 / call2 calls / 30d

Yield.xyz MCP · Actions Manage

mcp.yield.xyz

Build unsigned transactions for pending actions on an existing DeFi position — claim rewards, restake, unlock, or complete a withdrawal — across 80+ networks. Use the action type and passthrough from yields_get_balances pendingActions[]. Does NOT execute: the caller signs and broadcasts each tx.

POSTBaseOnchain Data
$0.001 / call1 calls / 30d