Quickstart - Robin Markets

Example Code

Checkout the frontend example code for easy integration.

The fastest path to a Robin integration runs almost entirely through the read-only Integration API: index a Polymarket market, read its staking APY, and quote a personalized stake. Sending the deposit is the only on-chain step, covered in Deposits. The base URL is https://app.robin.markets/api/v1. There is no auth and CORS is open, so every call below works from the browser or a server.

All token and USDC amounts are 6-decimal integer strings ("1500000" = 1.5). APY values are plain numbers in percent (6 = 6.00%). A conditionId is the Polymarket condition id (bytes32 hex) and is the primary key everywhere.

Index the market

POST /markets is the only mutating call in the API. It indexes any conditionIds Robin doesn’t know yet — pulling them from Polymarket — and returns the same { markets, notFound } shape as GET /markets, so the response is directly usable.You can pass any Polymarket conditionId, whether or not Robin has seen it before.

curl -X POST https://app.robin.markets/api/v1/markets \
  -H "Content-Type: application/json" \
  -d '{"conditionIds":["0xabc…"]}'

const res = await fetch("https://app.robin.markets/api/v1/markets", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ conditionIds: ["0xabc…"] }),
});
const { markets, notFound } = await res.json();

Reads (GET /markets, GET /markets/{conditionId}) are pure — they never write. A 404 or a notFound entry just means “not indexed yet”. Call POST /markets once to index it from Polymarket, then read.

Read the APY headline

Each entry in the returned markets[] carries an APY breakdown. The headline fields are numbers in percent:

Field	Meaning
`apy.yes`	Total projected APY for the YES side
`apy.no`	Total projected APY for the NO side
`apy.min`	Lower bound across both sides
`apy.max`	Upper bound across both sides
`apy.base`	Organic on-chain yield component, floored at the guarantee

The total folds three Robin bonuses on top of the organic base: the 6% guarantee floor, the +1% matching bonus for the minority (pool-balancing) side, and the +1% points boost. Points are abstracted away — they appear only as a line in the APY response, never as something you handle directly.Use apy.min and apy.max for user-friendly apy display.

The three bonuses are an off-chain programme run by Robin: they are computed at withdrawal and paid in a single USDC transaction from Robin’s operator wallet, separate from the on-chain withdrawal. The vault itself pays only the organic yield (apy.base).

Read the APY headline

Each entry in the returned markets[] carries an APY breakdown. The headline fields are numbers in percent:

Field	Meaning
`apy.yes`	Total projected APY for the YES side
`apy.no`	Total projected APY for the NO side
`apy.min`	Lower bound across both sides
`apy.max`	Upper bound across both sides
`apy.base`	Organic yield component, floored at the guarantee

Quote a personalized stake

GET /quote projects the APY a specific wallet would earn for a given stake. Pass wallet, the conditionIds, and aligned yesAmounts / noAmounts (6-decimal strings).

curl "https://app.robin.markets/api/v1/quote?wallet=0x…&conditionIds=0xabc…&yesAmounts=1000000&noAmounts=0"

The response includes a projectedApy breakdown for that wallet:

{
  "projectedApy": {
    "total": 8,      // percent
    "base": 6,       // organic on-chain yield, floored at the guarantee
    "matching": 1,   // +1% for the pool-balancing side, if applicable
    "points": 1      // +1% × points coverage, personalized to this wallet
  }
}

wallet is the user’s Polymarket on-chain account (a DepositWallet or legacy Gnosis Safe proxy), not their EOA. The points component is personalized to that wallet, so resolving it correctly matters. See Wallets.

Quote a personalized stake

GET /quote projects the APY a specific wallet would earn for a given stake. Pass wallet, the conditionIds, and aligned yesAmounts / noAmounts (6-decimal strings).

curl "https://app.robin.markets/api/v1/quote?wallet=0x…&conditionIds=0xabc…&yesAmounts=1000000&noAmounts=0"

The response includes a projectedApy breakdown for that wallet:

{
  "projectedApy": {
    "total": 8,      // percent
    "base": 6,       // organic yield, floored at the guarantee
    "matching": 1,   // +1% for the pool-balancing side, if applicable
    "points": 1      // +1% × points coverage, personalized to this wallet
  }
}

Let the user stake on-chain

Quoting is read-only. Actually staking means building and sending a deposit transaction from the user’s resolved wallet — the only on-chain step in this flow.The transport depends on the wallet kind (DepositWallet push vs. Safe proxy pull or push), and a fresh TWAP is required before the vault accepts the deposit. See Deposits for the full transaction-building walkthrough.

Next steps

API overview

Conventions, rate limits, and the full endpoint surface.

Deposits

Build and send the on-chain deposit transaction.

Wallets

Resolve the user’s Robin staking wallet before any read or write.

Example Code

​Next steps

API overview

Deposits

Wallets

Next steps