# Robin Markets

> Robin Markets lets you stake Polymarket outcome tokens and earn passive DeFi yield without losing your market exposure or taking on liquidation risk.

## Docs

- [Vault deposit capacity](https://docs.robin.markets/api-reference/capacity/vault-deposit-capacity.md): The vault's GLOBAL (vault-wide) deposit capacity: `remainingUsdc` is how much USDC it can still absorb, and `fits` says whether a prospective batch would deposit without reverting. With no params it returns just the headroom. Pass a deposit batch (`conditionIds` + aligned `yesAmounts`/`noAmounts`) t…
- [A wallet's position in one market](https://docs.robin.markets/api-reference/markets/a-wallets-position-in-one-market.md): A wallet's existing position in a single market: shares, value, accrued-yield breakdown, and live `positionApy`. Returns `hasPosition: false` (with zeroed fields) when the wallet holds no stake in this market.
- [Batch market staking headlines](https://docs.robin.markets/api-reference/markets/batch-market-staking-headlines.md): Staking APY headline for many markets in one call. Each found market is returned in `markets` (same shape as GET /markets/{conditionId}); unknown conditionIds are listed in `notFound`. Address-agnostic — use /quote for personalized APY.
- [Batch personalized quotes](https://docs.robin.markets/api-reference/markets/batch-personalized-quotes.md): Personalized quote for many markets in one call. `yesAmounts`/`noAmounts` are comma-separated 6-dec micro-units aligned 1:1 with `conditionIds` (omit either for all-zero on that side). Each `quotes` entry is an INDEPENDENT quote (identical to GET /markets/{conditionId}/quote): its `points` coverage…
- [Index markets (mutating)](https://docs.robin.markets/api-reference/markets/index-markets-mutating.md): The ONLY mutating endpoint — every GET is a pure read. Indexes the given markets (any conditionId Robin doesn't know yet is fetched from Polymarket and upserted), then returns the SAME shape as GET /markets (`{ markets, notFound }`) so the result is directly usable with no follow-up read. conditionI…
- [Market staking APY headline](https://docs.robin.markets/api-reference/markets/market-staking-apy-headline.md): Address-agnostic per-side APY headline for one market: socialized base + matching bonus. Points are not personalized here (no wallet) — `apy.maxPointsBoost` is the "up to" ceiling; use the `/quote` endpoint for a wallet's actual points boost.
- [Personalized stake quote](https://docs.robin.markets/api-reference/markets/personalized-stake-quote.md): Projected APY for a *potential* deposit of `yesAmount` + `noAmount` into one market, for the given wallet's portfolio. Mirrors the deposit contract (both sides at once). `projectedApy` breaks the total into `base` + `matching` + `points` (points also folded into `total`). Omit the amounts for a head…
- [Contract addresses](https://docs.robin.markets/api-reference/meta/contract-addresses.md): The addresses an integrator needs to build stake/unstake transactions themselves (the API is read-only and does not relay).
- [All of a wallet's positions](https://docs.robin.markets/api-reference/positions/all-of-a-wallets-positions.md): All of a wallet's Robin positions, paginated. Each entry is a full `Position`.
- [Fetch a signed TWAP oracle update](https://docs.robin.markets/api-reference/twap/fetch-a-signed-twap-oracle-update.md): Returns a signed TWAP price update for the given markets — required before a deposit or withdrawal, since the vault rejects a stake whose TWAP is stale. The response has two modes. On-chain mode (`txHash` present): the oracle already refreshed on-chain and you submit nothing. Signed mode (`markets`…
- [Robin Markets Beta Program: Legacy Points and TVL Migration](https://docs.robin.markets/beta-program.md): If you participated in a previous Robin Markets beta, your TVL is still accessible and your points carry over with a 10x multiplier to the new product.
- [Robin Markets Smart Contract Audit Reports by Phage Security](https://docs.robin.markets/contracts/audit-reports.md): Robin Markets V2, V1, and beta contracts have all been independently audited by Phage Security. Review the full audit reports here.
- [Robin Markets Smart Contract Addresses on Polygon Network](https://docs.robin.markets/contracts/overview.md): The full list of Robin Markets V2 and V1 smart contract addresses deployed on Polygon, including vault, oracle and lens contracts.
- [Robin Markets Risk Guide: Smart Contracts and Liquidity](https://docs.robin.markets/contracts/risks.md): Robin Markets carries smart contract risk and potential temporary liquidity constraints. Learn what risks you take on and how Robin mitigates them.
- [Integration API overview](https://docs.robin.markets/developers/api-overview.md): The read-only /api/v1 surface: base URL, conventions, the index-then-read flow, and the APY breakdown — endpoint schemas live in the API Reference.
- [Architecture](https://docs.robin.markets/developers/architecture.md): How the Robin Staking Vault pairs and merges Polymarket positions into USDC, supplies it to a yield strategy, and tracks yield with ERC-1155 shares.
- [Deposit capacity](https://docs.robin.markets/developers/capacity.md): The vault has a finite, two-tier deposit capacity. Check it before staking so a deposit doesn't revert — over HTTP via GET /api/v1/capacity, or on-chain via RobinLens.
- [Units, IDs & APY](https://docs.robin.markets/developers/conventions.md): The shared conventions across Robin's contracts and API: 6-decimal amounts, scales, conditionId, the Side enum, and the APY formula.
- [Depositing (staking)](https://docs.robin.markets/developers/deposits.md): Stake Polymarket YES/NO tokens into the vault — the pull path (approve, batchDeposit, revoke) and the push path (a single CTF transfer).
- [Robin Markets developer documentation](https://docs.robin.markets/developers/index.md): Integrate Robin Markets to show live staking APY and let your users stake their Polymarket positions for yield.
- [Quickstart](https://docs.robin.markets/developers/quickstart.md): Index a market, read its staking APY, and quote a stake — then point users at the on-chain deposit.
- [Reading on-chain state](https://docs.robin.markets/developers/reading-onchain-state.md): Query a wallet's shares, loss-adjusted assets, and pending yield — plus market state and previews — with the stateless RobinLens aggregator.
- [Refreshing the TWAP oracle](https://docs.robin.markets/developers/twap.md): Each market's TWAP must be fresh before a deposit or withdrawal — fetch a signed update from Robin's API and prepend submitTwap to your batch.
- [Wallets & accounts](https://docs.robin.markets/developers/wallets.md): Robin keys everything on the user's Polymarket on-chain account — a DepositWallet or a Gnosis Safe proxy — not their EOA. Resolve it once and use it everywhere.
- [Withdrawing (unstaking)](https://docs.robin.markets/developers/withdrawals.md): Burn vault shares to get your Polymarket tokens and organic yield back, via batchWithdraw — works the same for both wallet kinds.
- [Robin Markets FAQ: Fees, Safety, Wallets, and Withdrawals](https://docs.robin.markets/faq.md): Answers to the most common questions about Robin Markets — fees, safety, supported wallets, withdrawal speed, and how yield and bonuses are paid.
- [How Robin Markets Works: Stake, Merge, Earn, Withdraw](https://docs.robin.markets/how-it-works.md): Step-by-step walkthrough of how Robin Markets stakes Polymarket tokens, merges opposing positions into USDC, and deploys capital to earn DeFi yield.
- [Robin Markets: Capital Efficiency for Prediction Markets](https://docs.robin.markets/introduction.md): Robin Markets lets you stake Polymarket outcome tokens and earn passive DeFi yield without losing your market exposure or taking on liquidation risk.
- [Robin Markets Community, Website, and Social Links](https://docs.robin.markets/socials-and-links.md): Connect with Robin Markets on X and Discord, visit the web app, and find all official links to stay informed, get support, and follow product updates.
- [Yield Guarantee and Matching Bonus — Robin Markets](https://docs.robin.markets/yield-guarantee.md): Robin Markets guarantees a minimum 6% APY on every staked position and pays an extra 1% APY matching bonus for deposits that help balance market pools.
- [How Robin Tracks and Distributes Yield to Stakers](https://docs.robin.markets/yield-tracking.md): Robin uses share-based vault accounting and a TWAP oracle to distribute yield fairly across stakers by market, pool side, and deposit amount.

## OpenAPI Specs

- [v1](https://docs.robin.markets/openapi/v1.yaml)

## Optional

- [Website](https://robin.markets)
- [Blog](https://substack.com/@robinmarkets)
- [Github](https://github.com/robin-markets)
- [X](https://x.com/robinmarketsxyz)
- [Discord](https://discord.gg/jskXXYUNU3)