# YieldPoint

## Docs

- [Returns token balance history for a given address.](https://docs.yieldpoint.io/api-reference/address/returns-token-balance-history-for-a-given-address.md)
- [Returns ecosystem-level data for UTY and yUTY tokens](https://docs.yieldpoint.io/api-reference/ecosystem/returns-ecosystem-level-data-for-uty-and-yuty-tokens.md)
- [Get health](https://docs.yieldpoint.io/api-reference/health/get-health.md)
- [Returns a list of points per user](https://docs.yieldpoint.io/api-reference/leaderboard/returns-a-list-of-points-per-user.md)
- [Returns a list of points per user including given address](https://docs.yieldpoint.io/api-reference/leaderboard/returns-a-list-of-points-per-user-including-given-address.md)
- [Returns multi-chain transaction history for a given wallet address.](https://docs.yieldpoint.io/api-reference/transactions/returns-multi-chain-transaction-history-for-a-given-wallet-address.md): Returns up to 500 lifecycle rows ordered newest-first. Each request targets a single chain via the required `chainId` query parameter: `8453` (Base, hub), `43114` (Avalanche, spoke), or `747474` (Katana, spoke). The query parameter filters by `requestedOnChainId` — the chain where the activity was i…
- [Returns UTY total supply](https://docs.yieldpoint.io/api-reference/uty/returns-uty-total-supply.md)
- [Returns yUTY APY](https://docs.yieldpoint.io/api-reference/yuty/returns-yuty-apy.md)
- [User guides](https://docs.yieldpoint.io/guides/coming-soon.md): Step-by-step guides for depositing, redeeming, withdrawing, claiming, and bridging UTY and yUTY.
- [Contracts](https://docs.yieldpoint.io/protocol/architecture/contracts.md): Deployed YieldPoint contract addresses, plus the contract layer organization and inheritance chains.
- [Core flows](https://docs.yieldpoint.io/protocol/architecture/flows.md): How deposits, redemptions, and cross-chain operations route through the YieldPoint contracts.
- [Overview](https://docs.yieldpoint.io/protocol/architecture/overview.md): How the YieldPoint protocol is structured: hub-spoke model, ERC-7540 vaults, and LayerZero messaging.
- [State distribution](https://docs.yieldpoint.io/protocol/architecture/state.md): Where YieldPoint protocol state lives across hub and spoke chains, and how operations route.
- [Tokens and fees](https://docs.yieldpoint.io/protocol/architecture/tokens-and-fees.md): How UTY and yUTY work as Omnichain Fungible Tokens on the hub and spoke chains, and the cross-chain fee economics.
- [Base operations](https://docs.yieldpoint.io/protocol/integration/base-operations.md): Deposit, withdraw, and claim flows that run directly on Base. UTY vault mint and redeem are Base-only; the yUTY vault is reachable either directly here or via the spoke cross-chain path.
- [Bridge operations](https://docs.yieldpoint.io/protocol/integration/bridge-operations.md): LayerZero V2 messaging, the DVN trust model, on-chain verification recipe, and the protocol-level defenses that layer on top of LayerZero.
- [Gotchas and known limits](https://docs.yieldpoint.io/protocol/integration/gotchas.md): Partner integration pitfalls and their fixes: controller parameter, InputMustBeSender vs InvalidRequest, multi-spoke origin tracking, and common revert signatures.
- [Integration overview](https://docs.yieldpoint.io/protocol/integration/overview.md): How YieldPoint's hub-and-spoke architecture shapes integration, plus a map of where to go for the flow you need.
- [Spoke chain operations](https://docs.yieldpoint.io/protocol/integration/spoke-chain-operations.md): Deposit yUTY and withdraw from a spoke chain (Avalanche, Katana). Spokes hold no vault state; they proxy calls cross-chain to the hub on Base via LayerZero.
- [Security](https://docs.yieldpoint.io/protocol/security.md): YieldPoint security model, audit summary, and trust assumptions.
- [MCP Server](https://docs.yieldpoint.io/protocol/tooling/mcp-server.md): Model Context Protocol server exposing YieldPoint state and actions to AI agents.
- [Payable Router](https://docs.yieldpoint.io/protocol/tooling/payable-router.md): Router contract for accepting payments in arbitrary tokens and settling in UTY or yUTY.
- [SDK](https://docs.yieldpoint.io/protocol/tooling/sdk.md): Typed client for reading YieldPoint state and submitting deposit, redeem, withdraw, claim, and bridge transactions.
- [x402 & Agents](https://docs.yieldpoint.io/protocol/tooling/x402.md): UTY and yUTY support EIP-3009 and EIP-2612 today across Base, Avalanche, and Katana. Hosted x402 endpoints are on the way.

## OpenAPI Specs

- [json](https://api.yieldpoint.io/docs/json)

## Optional

- [Blog](https://paragraph.com/@yieldpoint)