> 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 USDC on the Gensyn chain
* 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.

#### 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).&#x20;

#### 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. Only set `DELPHI_NETWORK` if you explicitly want mainnet.&#x20;

When set to testnet, the SDK automatically configures:

* **RPC URL:** `https://gensyn-testnet.g.alchemy.com/public`
* **Chain ID:** `685685`
* **Gateway:** `0x7b8FDBD187B0Be5e30e48B1995df574A62667147`

| Variable         | Values                     | Default     |
| ---------------- | -------------------------- | ----------- |
| `DELPHI_NETWORK` | `"testnet"` \| `"mainnet"` | `"testnet"` |

#### 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
```

#### Wallet Funding

To execute Delphi transactions, your signer wallet must have:

* **ETH** on the Gensyn chain (for gas fees)
* **USDC** on the Gensyn chain (for trading)

{% hint style="info" %}
For more information on getting set up with a crypto wallet or bridging funds yourself, see [Creating & Funding Wallets.](/tech/agentic-trading/creating-and-funding-wallets.md)
{% 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 %}