Skip to content

Developers

Build on Split. The SDK wraps quotes, gasless buys, and closes, so you can add leveraged options to any app with one signature per action.

Install

bash
npm install @splitmarkets/sdk

The shape of an integration

Every trade follows one pattern: quote, build calls, submit gasless.

  quote(side, strike, size)
        │  signed premium + bid + signature

  build calls  ─▶  [ pull premium (EIP-3009), approve, buyN ]
        │          (close: [ approve, sellN ])

  submit  ─▶  gasless facilitator  ─▶  one user signature, no ETH gas
  1. Quote: fetch a signed quote for a side (long or short), strike, and size. The quote carries the premium, the bid, and the signature the pool verifies.
  2. Build calls: the SDK assembles the batched calls, pull the premium (EIP-3009), approve, and buyN (or approve and sellN to close). Auto-exercise enrollment is appended for calls.
  3. Submit: relay the batch through the gasless facilitator. The user signs once and pays no ETH gas.

TIP

The same gasless functions power the production app, so your integration uses the same production execution path used by the Split app, not a parallel implementation.

Core concepts

ConceptNote
Sidelong is a call (WETH-collateralized), short is a put (USDC-collateralized)
Nthe option token the user holds, what you buy and sell
seriesIdidentifies a specific strike and expiry rung
premium / bidpremium is the entry cost (max loss), bid is the live close value
gaslessEIP-3009 signed USDC transfer plus account abstraction, one signature, no ETH

Contracts and addresses

WARNING

Resolve live contract addresses from the app or SDK config rather than hardcoding. Pools and exercisers are versioned and chain specific. Verify any address in the app before sending funds.

  • Chains: live on Base and Arbitrum. Auto-exercise is Base-only today (the Arbitrum exerciser is coming); on Arbitrum, close before expiry to realize a win.
  • The settlement core is the subject of the formal verification work. See Research.

Reference

  • The SDK README and SKILL.md ship inside the @splitmarkets/sdk package.
  • For settlement guarantees and what is proven, see Research and the split-fv repo.

Trade at your own risk. Nothing here is financial advice.