Configuration

Client options

new Cesto({
  apiKey: 'cesto_sk_…',       // required — the constructor throws without it
  timeout: 60_000,            // per-request timeout in ms — default 60s
  maxRetries: 2,              // automatic retries on transient errors — default 2
  fetch: customFetch,         // optional custom fetch implementation
});

string

Secret API key. Required — the constructor throws if omitted; the SDK does not read environment variables.

number

default:"60000"

Per-request timeout in milliseconds.

number

default:"2"

Max automatic retries on transient failures (408, 429, 5xx, network errors, timeouts).

typeof fetch

Custom fetch implementation (e.g. undici). Defaults to the global fetch.

Per-request options

Every method accepts an options object as its last argument to override transport behavior for a single call:

await cesto.products.list(
  { category: 'defi' },
  { timeout: 5_000, maxRetries: 0, signal: controller.signal },
);

number

Override the client timeout for this request.

number

Override retries for this request (e.g. 0 to disable).

AbortSignal

Cancel the request; composed with the internal timeout.

​Client options

​Per-request options

Client options

Per-request options