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

# 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](#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](/tools/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](/tools/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](/tools/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](/tools/agentic-trading/usage-guide.md) for more in-depth information.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.delphi.fyi/tools/agentic-trading/get-started.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.