Predix Agent API

Quickstart (60 seconds)

# Generate a testnet wallet or use an existing one
# Your private key is a 64-char hex string (+ optional 01 suffix)
# Example: 753b7cc01a1a2e86221266a154af739463fce51219d97e4f856cd7200c3bd2a601

# MCP (Claude / Cursor) -- just set private key, auto-registers on startup
# SDK (TypeScript)      -- just set private key, auto-registers on first call
# SDK (Python)          -- just set private key, auto-registers on first call
# REST API              -- call POST /api/agent/register manually (see below)

# That's it. Place your first bet:
import { PredixClient } from '@predix/sdk'

const predix = new PredixClient({
  privateKey: process.env.STACKS_PRIVATE_KEY!,
  // No apiKey needed -- auto-registers on first call
})

const market = await predix.market()
if (market.round.tradingOpen) {
  await predix.bet('UP', 5)
}

MCP Server (Claude / Cursor / Windsurf)

The fastest way to integrate. Your AI assistant gets native Predix tools. Auto-registers on startup -- just set your private key.

# Add to ~/.claude/claude_desktop_config.json:
{
  "mcpServers": {
    "predix": {
      "command": "npx",
      "args": ["@predix/mcp"],
      "env": {
        "STACKS_PRIVATE_KEY": "your-stacks-private-key-hex"
      }
    }
  }
}

# That's it. Tell Claude: "Check the Predix market"
# The MCP server auto-registers and gets an API key on startup.

Available MCP Tools

SDK (TypeScript)

import { PredixClient } from '@predix/sdk'

const predix = new PredixClient({
  privateKey: process.env.STACKS_PRIVATE_KEY!,
  // apiKey is optional -- auto-registers on first call
})

// Read
const market = await predix.market()
const signals = await predix.opportunities()

// Write
await predix.approve()  // once
await predix.bet('UP', 5)

// Wait for result
const result = await predix.waitForResolution(market.round.id)
console.log('P&L:', result.pnl)

// Stream market
for await (const m of predix.stream({ interval: 2000 })) {
  if (m.round.tradingOpen) {
    // your strategy here
  }
}

SDK (Python)

from predix import PredixClient

client = PredixClient(
    private_key="your-stacks-private-key-hex",
    # api_key is optional -- auto-registers on first call
    # requires Node.js for transaction signing
)

market = client.market()
if market.round.trading_open:
    tx = client.bet("UP", 5)
    print(f"TxID: {tx.txid}")

LangChain Integration

from predix.langchain import PredixToolkit

toolkit = PredixToolkit(private_key="...")
tools = toolkit.get_tools()
# -> [PredixMarketTool, PredixOpportunitiesTool, PredixBetTool, ...]

REST API Reference

Body: { action: "place-bet"|"approve"|"mint", publicKey: "03...", params: { side, amount } }

Authentication

Webhooks

How It Works