Examples

Runnable TypeScript examples covering the whole SDK surface.

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 products

Requires Node.js 20.6+.

What’s included

Example	Run	Docs
List products (+ backtests)	pnpm products	Products
Product detail + chart	pnpm product	Products
Positions by wallet	pnpm positions	Positions
Live position in one basket	pnpm position	Positions
Open a position (one call)	pnpm open --yes	Open a Position
Close a position (one call)	pnpm close --yes	Close a Position
Explicit prepare → sign → submit → poll	pnpm split-flow --yes	Open a Position
Typed errors, overrides, cancellation	pnpm errors	Errors & Retries

The open / close / split-flow examples execute real swaps on Solana mainnet from the wallet you configure, and that wallet pays its own gas. They refuse to run without an explicit --yes flag — use a dedicated test wallet with small amounts, and a write-scoped API key (see Authentication).