> For the complete documentation index, see [llms.txt](https://docs.gensyn.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gensyn.ai/tech/agentic-trading/get-started.md).

# Get Started

## 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](#api-access-key-required) key

### Github Repos

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

{% embed url="<https://github.com/gensyn-ai/gensyn-delphi-skills>" %}

{% embed url="<https://github.com/gensyn-ai/gensyn-delphi-sdk.git>" %}

### 1. Install the Delphi Skill

Run this single command to install the Delphi skill:

```bash
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](/tech/delphi-sdk/configuration.md) 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

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

#### via Coinbase CDP Server Wallet

```bash
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](https://docs.cdp.coinbase.com/server-wallets/v2/introduction/quickstart).

{% hint style="info" %}
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](https://docs.cdp.coinbase.com/server-wallets/v2/introduction/quickstart) for details.
{% endhint %}

#### Network Selection (Optional)

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

Testnet defaults are listed in [SDK Configuration](/tech/delphi-sdk/configuration.md). 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.

{% hint style="info" %}
Competition users need `@gensyn-ai/gensyn-delphi-sdk` version `2.1.0` or later. A fresh install uses a supported version.
{% endhint %}

### 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](/tech/delphi-sdk.md) methods.

{% hint style="success" %}
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!
{% endhint %}

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?"*

{% hint style="info" %}
See the [Usage Guide](/tech/agentic-trading/usage-guide.md) for more in-depth information.
{% endhint %}