Examples

The cesto-sdk-examples repository is a small TypeScript app with one runnable script per SDK feature (via tsx, no build step) — clone it, add your API key, and run any example:

git clone https://github.com/cesto-co/cesto-sdk-examples
cd cesto-sdk-examples
pnpm install
cp .env.example .env   # add your CESTO_API_KEY (and wallet vars for the write examples)

pnpm byow:products

Requires Node.js 20.6+. The repo covers both integration tracks:

BYOW (byow:*) — client-signed flows: your own Solana wallet signs every write (open / close / split-flow / bridges).
Managed (managed:*) — the managed-wallets flow: users.create + *.start, with Cesto signing server-side — no key handling on your side. See Managed Wallets.

What’s included

Example	Run	Docs
BYOW: List products (+ backtests)	`pnpm byow:products`	Products
BYOW: Product detail + chart	`pnpm byow:product`	Products
BYOW: Positions by wallet	`pnpm byow:positions`	Positions
BYOW: Live position in one basket	`pnpm byow:position`	Positions
BYOW: Open a position (one call)	`pnpm byow:open --yes`	Open a Position
BYOW: Close a position (one call)	`pnpm byow:close --yes`	Close a Position
BYOW: Explicit prepare → sign → submit → poll	`pnpm byow:split-flow --yes`	Open a Position
BYOW: Typed errors, overrides, cancellation	`pnpm byow:errors`	Errors & Retries
BYOW: Bridge USDC Base → Solana	`pnpm byow:bridge:base-to-solana --yes`	Bridging (CCTP)
BYOW: Bridge USDC Solana → Base (withdrawal)	`pnpm byow:bridge:solana-to-base --yes`	Bridging (CCTP)
Managed: Provision a user + wallet	`pnpm managed:user`	Managed Wallets
Managed: Fund the wallet from Base	`pnpm managed:fund --yes`	Managed Wallets
Managed: Open a position	`pnpm managed:open --yes`	Managed Wallets
Managed: Exercise every GET endpoint	`pnpm managed:gets`	Positions
Managed: Close a position	`pnpm managed:close --yes`	Close a Position
Managed: Check wallet balances	`pnpm managed:balances`	Managed Wallets

The open / close / split-flow / bridge and managed write examples move real USDC on mainnet (Solana and Base), spending from the wallets you configure (Cesto sponsors open/close gas). Write examples refuse to run without an explicit --yes flag — use dedicated test wallets with small amounts, and a write-scoped API key (see Authentication).

Get started

Widgets

Web SDK

Server SDK

What’s included

​What’s included

What’s included