# Spiral Stake

- [Overview](https://docs.spiralstake.xyz/overview.md): Spiral Stake is a non-custodial leverage execution layer built on Morpho — loop yield-bearing collateral for amplified stablecoin yield, or go leveraged long.
- [Getting Started](https://docs.spiralstake.xyz/getting-started.md): Open your first leveraged yield position: browse Morpho markets, pick a correlated or non-correlated strategy, set leverage, and confirm one transaction.
- [How It Works](https://docs.spiralstake.xyz/how-it-works.md): How flash leverage works: Spiral Stake collapses the whole deposit-borrow-swap-redeposit loop into one atomic transaction using Morpho's zero-fee flash loans.
- [Risks](https://docs.spiralstake.xyz/risks.md): Liquidation, depeg, oracle and smart-contract risk on leveraged yield positions — and the 0.25% LTV buffer Spiral Stake enforces before liquidation.
- [Security](https://docs.spiralstake.xyz/security.md): Every position runs in its own isolated UserProxy contract, with reentrancy guards and flash-loan callbacks validated against the Morpho contract address.
- [Audits](https://docs.spiralstake.xyz/audits.md): Spiral Stake V2 was audited by three independent security firms across the full development lifecycle, from initial build to deployment. Read the reports.
- [Fees](https://docs.spiralstake.xyz/fees.md): Spiral Stake charges one fee: a swap fee at position entry, 5 bps on correlated markets and 25 bps on non-correlated markets. No management fee, no performance fee, and nothing charged for as long as your position stays open.
- [FAQs](https://docs.spiralstake.xyz/faqs.md): Which assets you can leverage, which chains are supported, how liquidation works, and what happens when you close a leveraged yield position on Spiral Stake.
- [Glossary](https://docs.spiralstake.xyz/glossary.md): Plain-English definitions for leveraged yield: collateral token, correlated pair, deleverage, LTV, liquidation threshold, flash loan, looping and UserProxy.
- [Current Architecture](https://docs.spiralstake.xyz/architecture.md): The contracts behind Spiral Stake V2: FlashLeverage, MarketPositionManager, SwapManager, and the per-user UserProxy clones that isolate every open position.
- [Contract Addresses](https://docs.spiralstake.xyz/contract-addresses.md): Verified contract addresses for Spiral Stake V2 on Ethereum mainnet (chainId 1) and Robinhood Chain (chainId 4663), with block-explorer links for each.
- [Introduction](https://docs.spiralstake.xyz/agents/introduction.md): The Spiral Stake MCP server — leveraged yield loops, perps and stock + yield vaults for AI agents, non-custodial.
- [Quickstart](https://docs.spiralstake.xyz/agents/quickstart.md): Connect any MCP client to Spiral Stake and run your first query.
- [Claude Desktop](https://docs.spiralstake.xyz/agents/connect/claude-desktop.md): Add the Spiral MCP to Claude Desktop.
- [Cursor](https://docs.spiralstake.xyz/agents/connect/cursor.md): Add the Spiral MCP to Cursor.
- [Other clients](https://docs.spiralstake.xyz/agents/connect/other-clients.md): Connect any MCP client, the Inspector, or your own SDK.
- [Strategies & risk facts](https://docs.spiralstake.xyz/agents/concepts/strategies.md): What a strategy is and how to read the raw facts an agent reasons over.
- [Oracle & exit liquidity](https://docs.spiralstake.xyz/agents/concepts/oracle-and-liquidity.md): The two facts that most determine a leveraged position's risk.
- [Non-custodial execution](https://docs.spiralstake.xyz/agents/concepts/non-custodial.md): How the build tools produce transactions without ever touching keys.
- [Chains](https://docs.spiralstake.xyz/agents/concepts/chains.md): Targeting Ethereum or Robinhood Chain.
- [Tools overview](https://docs.spiralstake.xyz/agents/tools/overview.md): The ten MCP tools and when to use each.
- [list_strategies](https://docs.spiralstake.xyz/agents/tools/list-strategies.md): List eligible leveraged-yield strategies with raw risk facts.
- [get_strategy](https://docs.spiralstake.xyz/agents/tools/get-strategy.md): Full raw facts for one strategy by its Morpho market id.
- [get_prices](https://docs.spiralstake.xyz/agents/tools/get-prices.md): Current USD prices for loan and collateral tokens.
- [simulate_leverage](https://docs.spiralstake.xyz/agents/tools/simulate-leverage.md): Deterministic preview of a leveraged position — no wallet needed.
- [build_leverage_tx](https://docs.spiralstake.xyz/agents/tools/build-leverage-tx.md): Build the unsigned transaction to open a leveraged position.
- [build_manage_tx](https://docs.spiralstake.xyz/agents/tools/build-manage-tx.md): Build the unsigned transaction to adjust or close an open position.
- [get_positions](https://docs.spiralstake.xyz/agents/tools/get-positions.md): Read a wallet's open and closed positions from chain state.
- [simulate_equity_deposit](https://docs.spiralstake.xyz/agents/tools/simulate-equity-deposit.md): Deterministic preview of a stock + yield equity-vault deposit — no wallet needed.
- [build_equity_deposit_tx](https://docs.spiralstake.xyz/agents/tools/build-equity-deposit-tx.md): Build the unsigned atomic batch to enter a stock + yield equity vault.
- [build_equity_exit_tx](https://docs.spiralstake.xyz/agents/tools/build-equity-exit-tx.md): Build the unsigned atomic batch that fully unwinds an open equity vault.
- [Find the best yield](https://docs.spiralstake.xyz/agents/guides/find-the-best-yield.md): Rank stable strategies by risk-adjusted leveraged APY.
- [Open a position](https://docs.spiralstake.xyz/agents/guides/open-a-position.md): From a chosen strategy to a signed, on-chain leveraged position.
- [Manage & close](https://docs.spiralstake.xyz/agents/guides/manage-and-close.md): Adjust or unwind an existing position.
- [Stock + yield vaults](https://docs.spiralstake.xyz/agents/guides/stock-plus-yield-vault.md): Hold a tokenized stock 1x and farm a yield loop with the borrowed share — on Robinhood Chain.
- [Rate limits & errors](https://docs.spiralstake.xyz/agents/reference/rate-limits-and-errors.md): Limits on the MCP endpoint and how failures are surfaced.
- [Discovery](https://docs.spiralstake.xyz/agents/reference/discovery.md): How agents and crawlers find the Spiral MCP.
- [Disclaimer](https://docs.spiralstake.xyz/agents/reference/disclaimer.md): Not financial advice.
- [Introduction](https://docs.spiralstake.xyz/integration/introduction.md): Embed Spiral Stake's leveraged-yield strategies into your app — non-custodial, via a keyed REST API.
- [Authentication](https://docs.spiralstake.xyz/integration/authentication.md): API keys for the partner endpoints.
- [Quickstart](https://docs.spiralstake.xyz/integration/quickstart.md): Discover, simulate, build, and hand off for signing — in four calls.
- [Integration flow](https://docs.spiralstake.xyz/integration/guides/integration-flow.md): The end-to-end shape of a Spiral integration.
- [Signing the transaction](https://docs.spiralstake.xyz/integration/guides/signing.md): How to execute the unsigned bundle a build returns.
- [Managing positions](https://docs.spiralstake.xyz/integration/guides/managing-positions.md): Read, adjust, and close a user's positions.
- [Fees & revenue share](https://docs.spiralstake.xyz/integration/guides/fees.md): How fees work and how partner revenue is reconciled.
- [Going live](https://docs.spiralstake.xyz/integration/guides/going-live.md): Checklist before you point real volume at the API.
- [Liveness + cache diagnostics](https://docs.spiralstake.xyz/api-reference/liveness-+-cache-diagnostics.md)
- [Readiness (warmer has primed required data)](https://docs.spiralstake.xyz/api-reference/readiness-warmer-has-primed-required-data.md)
- [One strategy by market id](https://docs.spiralstake.xyz/api-reference/one-strategy-by-market-id.md)
- [StableWatch stable-pool APY snapshot + history](https://docs.spiralstake.xyz/api-reference/stablewatch-stable-pool-apy-snapshot-+-history.md): The `{ stableApy: [...] }` snapshot the app previously fetched from the dashboard `/apy`. The mcp now owns this data. Not readiness-gated: serves last-good (or an empty list) with a visible stale flag.
- [Full composed Market[] for the v2-client app (raw domain model)](https://docs.spiralstake.xyz/api-reference/full-composed-market[]-for-the-v2-client-app-raw-domain-model.md): The internal Market model the app consumes in place of its own client-side composition. Unlike /v1/strategies (curated, string APYs), values keep full precision: BigNumber is tagged as {"$bn":"…"} and bigint as {"$bigint":"…"}; revive both client-side before use.
- [Borrow-APY history for all markets (charts)](https://docs.spiralstake.xyz/api-reference/borrow-apy-history-for-all-markets-charts.md)
- [Borrow-APY history for one market](https://docs.spiralstake.xyz/api-reference/borrow-apy-history-for-one-market.md)
- [Collateral-APY history for all markets (keyed by market id)](https://docs.spiralstake.xyz/api-reference/collateral-apy-history-for-all-markets-keyed-by-market-id.md)
- [Collateral-APY history for one market](https://docs.spiralstake.xyz/api-reference/collateral-apy-history-for-one-market.md)
- [Borrow-incentive (Merkl) APR history for one market](https://docs.spiralstake.xyz/api-reference/borrow-incentive-merkl-apr-history-for-one-market.md)
- [CoinGecko price chart (on-demand proxy)](https://docs.spiralstake.xyz/api-reference/coingecko-price-chart-on-demand-proxy.md)
- [All strategies (frozen contract)](https://docs.spiralstake.xyz/api-reference/public/all-strategies-frozen-contract.md)
- [Latest token/loan USD prices (address → price)](https://docs.spiralstake.xyz/api-reference/public/latest-tokenloan-usd-prices-address-→-price.md)
- [Preview opening a leveraged position (deterministic, no wallet)](https://docs.spiralstake.xyz/api-reference/partner/preview-opening-a-leveraged-position-deterministic-no-wallet.md)
- [Build the unsigned open-leverage transaction](https://docs.spiralstake.xyz/api-reference/partner/build-the-unsigned-open-leverage-transaction.md)
- [Build the unsigned manage/close transaction for a position](https://docs.spiralstake.xyz/api-reference/partner/build-the-unsigned-manageclose-transaction-for-a-position.md)
- [A wallet's open/closed positions](https://docs.spiralstake.xyz/api-reference/partner/a-wallets-openclosed-positions.md)
- [Errors](https://docs.spiralstake.xyz/integration/reference/errors.md): The error envelope and status codes.
- [Rate limits](https://docs.spiralstake.xyz/integration/reference/rate-limits.md): Per-partner rate tiers.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)

## Optional

- [App](https://app.spiralstake.xyz)
- [MCP endpoint](https://api.spiralstake.xyz/mcp)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.