Get Started

Clone the repo, install the skill, configure your environment, and start interacting with your agent.

Prerequisites

There are several dependencies required to enable Agentic Trading on Delphi:

• Node.js installed (npm -v to verify)

• A wallet with ETH for gas and collateral tokens: $TEST on testnet, USDC on mainnet, or TST on competition testnet

• A Delphi API access key

Github Repos

You can find the Agentic Trading Toolkit (ATT) Skills file and the Delphi SDK here.

GitHub - gensyn-ai/gensyn-delphi-skills: Skills for agents to view markets and place trades on Gensyn's Delphi prediction marketsGitHub

GitHub - gensyn-ai/gensyn-delphi-sdkGitHub

1. Install the Delphi Skill

Run this single command to install the Delphi skill:

npx skills add https://github.com/gensyn-ai/gensyn-delphi-skills --skill delphi

You'll then be prompted to choose a scope and install the skill to the agent(s) of your choice.

1. Choose a Scope:

   1. Global: The agent can use Delphi from any folder

   2. Project: The agent can only use Delphi when working with that specific subfolder

2. Select Agent(s): Use the space key to choose which agents to install the skill for (Claude Code, Cursor, Cline, etc.)

2. Configure Environment Variables

Create a .env file in the project root with your credentials. You need two things: [1] an API key and [2] wallet signing credentials.

API Access Key (Required)

See the SDK Configuration documentation for details on requesting a testnet or mainnet API access key.

competition-testnet uses the testnet API deployment. Use a testnet API key.

Wallet Signing (Required)

You have two options for wallet signing: either a [1] private key (which is easiest for development or a [2] Coinbase CDP server wallet (recommended for production use cases).

via Private Key

DELPHI_SIGNER_TYPE=private_key
WALLET_PRIVATE_KEY=0x<your-hex-private-key>

via Coinbase CDP Server Wallet

CDP_API_KEY_ID=<your-key-id>
CDP_API_KEY_SECRET=<your-key-secret>
CDP_WALLET_SECRET=<your-wallet-secret>
CDP_WALLET_ADDRESS=0x<your-wallet-address>

CDP Server Wallet is the default signer type. There is no need to set DELPHI_SIGNER_TYPE. You can get your CDP credentials from the Server Wallet v2 Quickstart.

With CDP Server Wallets, private keys are secured in Coinbase's Trusted Execution Environment (TEE) and never leave the TEE. See the Server Wallet v2 docs for details.

Network Selection (Optional)

The SDK defaults to testnet. Set DELPHI_NETWORK to select mainnet or the competition.

Testnet defaults are listed in SDK Configuration. Do not hardcode gateway addresses.

Competition testnet uses the testnet chain and RPC. It uses separate LMSR contracts and TST collateral with six decimals.

Variable	Values	Default
DELPHI_NETWORK	"testnet" | "mainnet" | "competition-testnet"	"testnet"
DELPHI_COMPETITION_ID	Optional competition ID; defaults to the active competition and is ignored elsewhere	—

Overrides (Optional)

These override network defaults if you need to point at a custom endpoint:

Variable	Description
GENSYN_RPC_URL	Custom RPC endpoint
GENSYN_CHAIN_ID	Custom chain ID
DELPHI_GATEWAY_CONTRACT	Custom gateway contract address
DELPHI_API_BASE_URL	Custom API base URL
DELPHI_SUBGRAPH_URL	Custom Goldsky subgraph endpoint

Example .env File

# Required
DELPHI_API_ACCESS_KEY=your-api-key-here

# Signing — Option A: Private key
DELPHI_SIGNER_TYPE=private_key
WALLET_PRIVATE_KEY=0xYourPrivateKeyHere

# Network (optional — defaults to testnet)
# DELPHI_NETWORK=testnet

# Competition (optional)
# DELPHI_NETWORK=competition-testnet
# DELPHI_COMPETITION_ID=  # Defaults to the active competition.

Wallet Funding

To execute Delphi transactions, your signer wallet must have:

• ETH on the Gensyn chain (for gas fees)

• $TEST on testnet, USDC on mainnet, or TST on competition testnet

Competition TST cannot be faucet-minted. Organizers distribute it after wallet registration. Gas still uses testnet ETH.

Competition users need @gensyn-ai/gensyn-delphi-sdk version 2.1.0 or later. A fresh install uses a supported version.

3. Start Using your Agent

Open your agent of choice and start interacting with Delphi. The agent will use the skill files to understand your intent and call the appropriate SDK methods.

The whole point of Agentic Trading is that you interact through natural language. So can you say "buy 10 shares of outcome 0" and the agent handles it. Get creative!

You can try something like:

• "Show me the open prediction markets"

• "What's the current price on [market name]?"

• "Buy 10 shares of outcome 0 on [market address]"

• "What are my current positions?"

See the Usage Guide for more in-depth information.