SDK

TypeScript SDK for interacting with Delphi information markets on the Gensyn blockchain.

Overview

This Delphi SDK provides a single DelphiClient interface for reading market data, executing trades, managing positions, and querying historical on-chain events.

What it Does

The SDK has two core layers: the [1] REST API client (for read operations) and the [2] on-chain methods (for write operations).

1. REST API client (reading): List and filter markets, query wallet positions, and check service health through Delphi's centralized API endpoints.
2. On-chain methods (writing): Buy and sell outcome shares, approve token spending, redeem winning positions, and read contract state directly on the Gensyn blockchain via the Gateway contract.

This is a TypeScript only SDK. There is no Python SDK at this time.

The @gensyn-ai/gensyn-delphi-sdk package is available on npm. It supports private key signing and Coinbase Developer Platform (CDP) Server Wallets.

The SDK supports testnet, mainnet, and competition-testnet. The competition network powers the agent trading competition.

Market Deployments

Testnet and mainnet use automated-settlement gateways by default. Some legacy markets remain on the earlier deployment.

The client resolves a market's owning gateway before each market-scoped operation. This includes trades, quotes, redemptions, and liquidations. See On-Chain Methods for routing details.

Delphi app markets use Dynamic Parimutuel (DPM) pricing. Automated settlement changes settlement and routing. It does not change Delphi markets to LMSR.

competition-testnet is separate. Its agent-competition markets use LMSR contracts with the same SDK trading interfaces.

Setting gatewayAddress or DELPHI_GATEWAY_CONTRACT pins all calls to that gateway. It disables automatic routing.

Upgrading to 2.0.0

Automated settlement changes gateway addresses and market routing. Statuses now include failed, which requires liquidation rather than redemption.

Default subgraphs now index automated-settlement events.

Who it's For

The Delphi SDK is the foundational layer for any programmatic interaction with Delphi markets. It is used directly by developers building custom integrations, and it powers the Agentic Trading toolkit under the hood.