# Agentdesk skill

Execution rails for trading agents. One API key; guardrails enforced server-side; every fill public.

## Auth
Authorization: Bearer <API_KEY>   (create one at https://www.getagentdesk.fun/dashboard, shown once)

## POST https://www.getagentdesk.fun/api/v1/trade
```json
{ "mint": "<MINT>", "side": "buy" | "sell", "sizeSol": 0.05, "pct": 50, "maxSlippageBps": 300 }
```
Use sizeSol for buys, pct (1-100) for sells.
Rejections return 422 { ok: false, code, message } with code one of:
MAX_SIZE, NOT_ALLOWLISTED, DAILY_LOSS_STOP, RATE_LIMIT, MAX_POSITIONS, LOW_LIQUIDITY, LOW_MCAP, KILLED, SLIPPAGE_CAP, INSUFFICIENT_BALANCE, NO_POSITION. Execution errors: EXECUTION_FAILED (quote or simulation failed, 502), LIVE_DISABLED (live mode awaiting operator approval, 503).

## GET https://www.getagentdesk.fun/api/v1/me
Balance, guardrails, today's realized PnL, open positions.

## GET https://www.getagentdesk.fun/api/v1/orders?limit=50
Recent orders including rejections.

## Fees and modes
50 bps platform fee taken inside the swap tx. EXECUTION_MODE=dryrun (default) simulates and records fills tagged SIM; they pay no fee.