Back

Prop Desk for Developers

Fund an account, trade live crypto perps and event-card index markets, and claim on-chain USDC payouts — all programmatically. Build bots, agents, or your own pro terminal on the same rails the desk runs on.

Status The REST API and the A2A agent card are live now. The Prop Desk SDK methods, the cymetica-eventtrader-mcp Prop tools, and a full suite of example bots ship in the repo today; the Python SDK is live on PyPI (pip install cymetica-eventtrader); the MCP package (uvx cymetica-eventtrader-mcp) is marked publishing until it hits the registries — install it from source in the meantime.

REST API SDK MCP / AI Agents HFT & WebSocket Agent Card

REST API

Base URL https://cymetica.com/api/v1/prop. Read endpoints are public; account actions need a Bearer JWT (or an X-API-Key). All money amounts are decimal strings.

Method	Path	Auth	Purpose
GET	/config	public	Tiers, fees, rules, venues
GET	/stats	public	Funded count, total paid out
GET	/reserve	public	On-chain proof-of-reserve
GET	/markets?venue=	public	Tradable symbols + mark price
POST	/signup	JWT	Open an account on a tier
POST	/pay-fast-track	JWT	Pay the fast-track fee
GET	/accounts/me	JWT	Account status + graduation
GET	/accounts/me/trades	JWT	Trade history
POST	/accounts/me/trades	JWT	Open a trade
POST	/accounts/me/trades/{id}/close	JWT	Close a trade
GET	/accounts/me/payouts	JWT	Accrued + paid-out history
POST	/accounts/me/payouts/claim	JWT	Claim payout (on-chain when live)

Open a trade (curl)

curl -X POST https://cymetica.com/api/v1/prop/accounts/me/trades \
  -H "Authorization: Bearer $EVT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"venue":"hyperliquid","coin":"BTC","side":"long","size":0.1,"leverage":10}'

SDK Python — live on PyPI TypeScript — publishing

The official cymetica-eventtrader SDK wraps every Prop Desk endpoint with typed methods, auth handling, and a streaming client. The Prop service ships in the SDK now (Python event_trader.prop, TypeScript et.prop); the Python package is live on PyPI (pip install cymetica-eventtrader, import name event_trader) — the TypeScript/npm upload is in flight, install from sdk/typescript until then.

Python

pip install cymetica-eventtrader            # or: pip install -e sdk/python

from event_trader import EventTrader

et = EventTrader(api_key="evt_...")          # or token=...
et.prop.signup(tier_id=3)                     # Pro $25K
et.prop.open_trade(venue="hyperliquid", coin="ETH", side="long",
                   size=0.5, leverage=10)
acct = et.prop.account()
print(acct.phase, acct.profit_pct, acct.graduation.target_met)
et.prop.claim_payout()

TypeScript

npm install cymetica-eventtrader

import { EventTrader } from "cymetica-eventtrader";
const et = new EventTrader({ apiKey: "evt_..." });
await et.prop.signup({ tierId: 3 });
await et.prop.openTrade({ venue: "event_cards", coin: "EVCDX-SPACEX",
                          side: "long", size: 100 });
const acct = await et.prop.account();

Example bots

A full institutional suite ships in sdk/python/examples/prop/ — an evaluation auto-trader, a defensive risk-managed bot, a fail-safe HFT market maker (idempotent orders + sequence-gap resync), a CLI pro terminal, and an MCP-driven AI agent. All run simulated by default. See the examples/prop/README.md for setup.

MCP Server for AI agents publishing

The cymetica-eventtrader-mcp server exposes the Prop Desk as Model Context Protocol tools, so Claude and other agents can evaluate, trade, and manage a funded account directly. The 10 Prop tools below ship in the server now; the uvx registry entry is publishing — run from event_trader_mcp/ in the repo until it lands.

claude mcp add cymetica-eventtrader-mcp -- uvx cymetica-eventtrader-mcp
# or from source:  claude mcp add cymetica-eventtrader-mcp -- python -m event_trader_mcp
# env: EVENT_TRADER_API_KEY, EVENT_TRADER_API_URL=https://cymetica.com

Prop tools: et_prop_config, et_prop_stats, et_prop_reserve, et_prop_markets, et_prop_signup, et_prop_account, et_prop_open_trade, et_prop_close_trade, et_prop_payouts, et_prop_claim — plus the prop://config resource.

HFT & Real-Time Data

Funded traders route flow through the same CLOB exchange the desk runs. For low-latency strategies use the WebSocket and the fail-safe order contract.

wss://cymetica.com/ws/clob — channels l2Book, trades, bbo, bbo_raw, l3Book, userOrders, userFills, balanceUpdate (private channels need a token).
wss://cymetica.com/ws/clob/binary — binary protocol for millisecond-sensitive HFT.
Order placement is idempotent via the X-Idempotency-Key header — reuse the same key across retries.
On a 503 / may_have_executed, never blind-retry: query order status by request_id first. The SDK does this for you.
Sequence-numbered L2 deltas: on a gap, send "snapshot" to resync.

Agent Card (A2A) live

EventTrader publishes a Google A2A agent card at /.well-known/agent-card.json for agent-to-agent discovery, including a Prop Desk skill. Point your agent framework at it to negotiate capabilities and authenticate.

EventTrader