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 event-trader-mcp Prop tools, and a full suite of example bots ship in the repo today; the published registry packages (pip install event-trader / uvx event-trader-mcp) are marked publishing until they hit PyPI/npm — install 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 & TypeScript publishing

The official event-trader 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 package upload to PyPI/npm is in flight — install from sdk/python / sdk/typescript in the repo until then.

Python

pip install event-trader            # 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 event-trader

import { EventTrader } from "event-trader";
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 event-trader-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 event-trader-mcp -- uvx event-trader-mcp
# or from source:  claude mcp add event-trader-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