stablecoin-yield

Query real-time stablecoin supply yield pools from Barker's index of 500+ DeFi protocols. Returns ranked rows with protocol_name, chain_name, asset_symbol, supply_apy_total (decimal — multiply by 100 for %), and supply_tvl (USD). Use for questions like 'best stablecoin yield', 'where to earn on USDC', 'compare lending rates', '稳定币利率'. (paid: $0.001 per call via x402)

{
  "type": "object",
  "properties": {
    "asset": {
      "type": "string",
      "description": "Stablecoin symbol (lowercase): usdt, usdc, dai, usde, usds, fdusd, gho, crvusd, pyusd, sdai, frxusd, tusd, lusd, dola, etc."
    },
    "chain": {
      "type": "string",
      "description": "Chain name (lowercase): ethereum, bsc, arbitrum, base, polygon, optimism, avalanche, solana, etc."
    },
    "sort": {
      "type": "string",
      "enum": [
        "apy",
        "tvl"
      ],
      "description": "Sort key"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Row count (default 50, max 100)"
    }
  }
}

Barker's stablecoin market snapshot: total market cap, yield-bearing cap, asset distribution, chain distribution. Use for 'stablecoin market cap', 'USDT market share', '稳定币市场份额'. share_pct fields are decimals (0.425 = 42.5%). (paid: $0.001 per call via x402)

{
  "type": "object",
  "properties": {}
}

Barker's historical APY trend for stablecoins vs. US Treasury benchmark over a lookback window (7–180 days). Use for 'DeFi vs treasury', 'is stablecoin APY going up', 'crypto yield trend', '稳定币利率走势'. (paid: $0.001 per call via x402)

{
  "type": "object",
  "properties": {
    "days": {
      "type": "integer",
      "minimum": 7,
      "maximum": 180,
      "description": "Lookback window in days (default 30)"
    }
  }
}

FLAGSHIP: 'Where should I park my stablecoins right now?' Returns a ranked top-N recommendation across Barker's DeFi yield index (500+ protocols) with data-derived reasons and risk flags per pick (APY vs market median, TVL depth, incentive-dependence, lock terms). Use for 'best place for my USDC', '钱放哪收益最好', 'recommend stablecoin yield with low risk'. APY unit: percent (6.2 = 6.2%). (paid: $0.03 per call via x402)

{
  "type": "object",
  "properties": {
    "asset": {
      "type": "string",
      "description": "Stablecoin symbol (lowercase): usdt, usdc, dai, usde, ..."
    },
    "chain": {
      "type": "string",
      "description": "Optional chain filter (lowercase)"
    },
    "risk": {
      "type": "string",
      "enum": [
        "conservative",
        "balanced",
        "aggressive"
      ],
      "description": "Risk band → TVL floor $10M/$1M/$100K"
    },
    "min_tvl": {
      "type": "number",
      "description": "Optional explicit TVL floor (USD)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Top-N picks (default 5)"
    }
  }
}

Full single-pool dossier from Barker's index by pool_uid: all APY components (percent unit), TVL, terms, execution capability, reward breakdown. Use after barker_defi_vaults / barker_yield_advisor to inspect one pool. (paid: $0.005 per call via x402)

{
  "type": "object",
  "properties": {
    "pool_uid": {
      "type": "string",
      "description": "Pool uid from list tools"
    }
  },
  "required": [
    "pool_uid"
  ]
}

Per-pool APY/TVL time series from Barker's index (default 30d, APY percent unit) for trend and volatility analysis of one pool_uid. Use for 'is this pool's APY stable', '这个池子收益稳不稳'. (paid: $0.005 per call via x402)

{
  "type": "object",
  "properties": {
    "pool_uid": {
      "type": "string"
    },
    "days": {
      "type": "integer",
      "minimum": 7,
      "maximum": 180
    }
  },
  "required": [
    "pool_uid"
  ]
}

Fuzzy search Barker's pool index by keyword (protocol name / pool name / asset). Resolves natural-language pool references to pool_uid for the detail/history tools. (paid: $0.001 per call via x402)

{
  "type": "object",
  "properties": {
    "keyword": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "keyword"
  ]
}

Barker's cross-chain route availability for a stablecoin from a given chain (bridge/venue coverage). Use for 'bridge USDC from arbitrum', '跨链路径'. (paid: $0.01 per call via x402)

{
  "type": "object",
  "properties": {
    "from_chain": {
      "type": "string",
      "description": "Origin chain (lowercase)"
    },
    "symbol": {
      "type": "string",
      "description": "Stablecoin symbol (lowercase)"
    }
  },
  "required": [
    "from_chain",
    "symbol"
  ]
}

EXECUTION DISCOVERY: which stablecoin vaults in Barker's index support direct deposit/redeem through barker_execution_quote. Returns executable pools with adapter support, live deposit capacity (is_full) and APY/TVL. Call this before barker_execution_quote — every pool listed here can be quoted, and its pool_uid is the exact string that tool expects (its vault_token_address works there too). Skip this call entirely if you already know the vault contract address. All parameters are optional: call with no arguments to get the top executable pools across every asset. APY unit: decimal (0.05 = 5%). Use for 'which pools can my agent actually deposit into', '哪些池子能直接存'. (paid: $0.01 per call via x402)

{
  "type": "object",
  "properties": {
    "asset": {
      "type": "string",
      "description": "Optional stablecoin symbol filter, case-insensitive: usdc, usdt. Omit to list all assets."
    },
    "chain": {
      "type": "string",
      "description": "Optional chain filter (lowercase), e.g. base, ethereum"
    },
    "query": {
      "type": "string",
      "description": "Optional pool keyword, e.g. 'Steakhouse USDC'"
    },
    "action": {
      "type": "string",
      "enum": [
        "deposit",
        "redeem"
      ],
      "description": "Filter by executable action"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Max rows (default 20)"
    },
    "min_tvl": {
      "type": "number",
      "description": "Min TVL floor in USD (default 1000000)"
    }
  }
}

EXECUTION QUOTE (non-custodial): buy an unsigned, ready-to-sign transaction that deposits into or redeems from a stablecoin vault. Returns transaction_request {chainId,from,to,data,value} + route + risk summary + approval info. Barker NEVER broadcasts and never holds funds — return the transaction to YOUR user's wallet to sign; vault shares always go to signer_address (receiver is not a parameter). Same-chain only (self/portals adapters). pool_uid takes EITHER a Barker pool_uid OR the vault contract address — if you already know the vault address, quote directly, no discovery call needed. Flow: barker_yield_advisor → barker_executable_pools → this tool → your user signs. Asset identity is resolved by the selected pool; symbols and underlying-asset token addresses are never accepted as identity (pass the VAULT contract, not the asset contract). If a pool has multiple possible underlying assets, the backend rejects ambiguity instead of guessing. Use for 'deposit 1000 USDC into this vault', '帮我把 USDC 存进这个池子（自己签名）'. (paid: $0.05 per call via x402)

{
  "type": "object",
  "properties": {
    "pool_uid": {
      "type": "string",
      "description": "Either the exact pool_uid from barker_executable_pools (copy verbatim), OR the vault contract address (0x + 40 hex) if that is what you already have — no discovery call needed. Both are matched exactly; partial names and keywords are rejected (POOL_NOT_FOUND), because this is a money path and Barker never guesses the pool. If one contract hosts several products (e.g. Pendle PT vs LP), you get 409 POOL_AMBIGUOUS with the exact candidates to choose from."
    },
    "chain_id": {
      "type": "integer",
      "description": "Optional, only useful when pool_uid is a contract address that is deployed at the same address on several chains (e.g. Aave aTokens). EVM chain id, e.g. 8453 for Base."
    },
    "action": {
      "type": "string",
      "enum": [
        "deposit",
        "redeem"
      ],
      "description": "Default deposit"
    },
    "amount_base_units": {
      "type": "string",
      "description": "Integer amount in token base units (1 USDC = 1000000). For redeem: underlying assets to withdraw. Send either this OR `amount` — not both (they are cross-checked and a mismatch is rejected)."
    },
    "amount": {
      "type": "string",
      "description": "Same amount in human units (\"1000\" = 1000 USDC), converted server-side using the pool's own asset decimals. Use this if you don't want to compute base units yourself. Alternative to amount_base_units."
    },
    "signer_address": {
      "type": "string",
      "description": "EVM address that will sign AND receive vault shares / redeemed assets. Mandatory — it is the tx sender and the share recipient, so Barker can never infer or default it."
    },
    "slippage": {
      "type": "number",
      "description": "Optional slippage tolerance, e.g. 0.005"
    }
  },
  "required": [
    "pool_uid",
    "amount_base_units",
    "signer_address"
  ]
}

VAULT POSITION (on-chain read): current redeemable value of a wallet's ERC-4626 vault position. Pass the pool_uid (from barker_executable_pools / barker_execution_quote) and the wallet address; Barker resolves the vault contract and reads balanceOf + convertToAssets directly on-chain, returning shares and current_value in the vault's underlying asset (value_asset, e.g. USDC). Barker does not store your deposit baseline — record the principal you deposited yourself; earned = current_value - your net deposits. Use after depositing via barker_execution_quote to monitor a position: 'how much is my vault position worth now', '我存进金库的 USDC 现在值多少'. (paid: $0.001 per call via x402)

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "EVM wallet address holding the vault shares (0x + 40 hex)"
    },
    "pool_uid": {
      "type": "string",
      "description": "Barker pool uid of the ERC-4626 vault, e.g. morpho-vault_base_usdc_0xee8f4ec5 (from barker_executable_pools)"
    }
  },
  "required": [
    "address",
    "pool_uid"
  ]
}