Quickstart

Discover strategies (public)

curl -s "https://api.spiralstake.xyz/v1/strategies?chainId=1"

Pick a strategy by its risk facts. No key needed.

Simulate a position

curl -s -X POST https://api.spiralstake.xyz/v1/partner/leverage/simulate \
  -H "authorization: Bearer $SPIRAL_KEY" \
  -H "content-type: application/json" \
  -d '{"strategyId":"0x…","payToken":"0x…","amount":"10000","leverage":3}'

Returns the deterministic positionPreview.

Build the unsigned transaction

curl -s -X POST https://api.spiralstake.xyz/v1/partner/leverage/build \
  -H "authorization: Bearer $SPIRAL_KEY" \
  -H "content-type: application/json" \
  -d '{"strategyId":"0x…","payToken":"0x…","amount":"10000","leverage":3,"userAddress":"0x…"}'

Returns { approvals, tx, meta }.

Your user signs

Send approvals[] first (if any), then tx, from userAddress — or hand them meta.signingUrl. See Signing.

TypeScript

const H = { authorization: `Bearer ${process.env.SPIRAL_KEY}`, "content-type": "application/json" };
const api = "https://api.spiralstake.xyz";

const build = await fetch(`${api}/v1/partner/leverage/build`, {
  method: "POST", headers: H,
  body: JSON.stringify({ strategyId, payToken, amount: "10000", leverage: 3, userAddress }),
}).then((r) => r.json());

// build.approvals[], build.tx {to,data,value}, build.meta.signingUrl

build.meta.expiresAt — the embedded swap calldata is valid ~60s. Build right before the user signs, and rebuild if it lapses.

Authentication Integration flow

Get Started

Guides

API Reference

Reference

TypeScript

​TypeScript

TypeScript