Integration flow

A Spiral integration is a thin orchestration layer on top of the API — you own the UX and the signing; Spiral supplies the data and the transactions.

Responsibilities

Spiral	You
Strategy data, prices, risk facts	Discovery UX
Deterministic position previews	Presenting the preview
Unsigned approvals + transaction	Prompting the user’s wallet to sign
Position reads	Position UX + tracking

Simulate before build — show users the outcome first.
Build with the user’s wallet address — approvals and onBehalfOf are bound to it.
Respect meta.expiresAt — rebuild if the ~60s swap-calldata window lapses.
Non-custodial — you never send Spiral a key; Spiral never moves funds.