--- name: tetrac description: AI-native multi-exchange trading platform. Index/directory for the TTC Box skill pack — registration, market data, trading across 29 perps venues, and pay-per-request data via x402 or MPP. Start here, then follow the link to the sub-skill that matches your task. license: Proprietary compatibility: Designed for Claude Code (or similar products) metadata: author: Tetrac version: "0.3.0" homepage: "https://ttc.box" emoji: "📊" category: "index" api_base: "https://ttc.box/api" --- ## What this file is This is the **root directory** for the TTC Box skill pack. It does not contain the API examples — each sub-skill does. Pick the skill that matches your task, fetch it, and follow it. ## Skill Directory Fetch any of these directly: | Skill | Purpose | URL | | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | | **onboarding** | Register a new agent/user, store the `authToken`, and verify connectivity. Covers the client-generated wallet + encrypted-key registration flow. | `https://ttc.box/skills/onboarding/SKILL.md` | | **market-data** | Read tickers, funding rates, open interest, volume snapshots, TTC scanner (TA signals), news, economic calendar, insights, listings, and quakes. | `https://ttc.box/skills/market-data/SKILL.md` | | **trading** | Place and cancel orders, manage positions, set leverage and hedge mode, read balances across 29 perps venues. | `https://ttc.box/skills/trading/SKILL.md` | | **x402-agent-payments** | Pay 0.05 USDC per `/api/v1/*` call directly on Solana mainnet. No API key, no facilitator — you submit the transfer, the server verifies on-chain. | `https://ttc.box/skills/x402-agent-payments/SKILL.md` | | **mpp-payments** | Pay 0.05 USDC per `/api/v1/*` call via the Machine Payments Protocol (Tempo EVM or Solana) using standard HTTP 402 challenges and an `mppx`-compatible client. | `https://ttc.box/skills/mpp-payments/SKILL.md` | **Install locally:** ```bash mkdir -p ~/.Tetrac/skills curl -s https://ttc.box/SKILL.md > ~/.Tetrac/skills/SKILL.md ``` Re-fetch any of the URLs above at any time to pick up updates. --- ## How to choose a skill | If you need to... | Go to | | --------------------------------------------------- | ----------------------- | | Get set up (register, auth token, first request) | **onboarding** | | Read prices, funding, scanner signals, news | **market-data** | | Place/cancel orders, manage positions, set leverage | **trading** | | Pay per request with a Solana wallet (no API key) | **x402-agent-payments** | | Pay per request via an MPP client (Tempo or Solana) | **mpp-payments** | Typical agent path: `onboarding` → `market-data` → `trading`. If you want to skip registration entirely and pay as you go, use `x402-agent-payments` or `mpp-payments`. --- ## Authentication modes TTC Box accepts three authentication modes. Pick one: 1. **Registered session** — register once (see `onboarding`), then send two headers on every `/api/v1/*` call: - `ttc-auth-token: ` - `ttc-public-key: ` 2. **x402 payment** — no registration. Pay 0.05 USDC on Solana per call and attach the `x-x402-payment` header. See the `x402-agent-payments` skill. 3. **MPP payment** — no registration. POST to `/api/v1/mpp` (Tempo) or `/api/v1/mpp/solana`, settle the 402 challenge, retry with the payment credential. See the `mpp-payments` skill. > **Do not** fabricate a registration request body from this file — the real payload requires client-generated wallets and encrypted keys. Fetch the `onboarding` skill and follow it. --- ## Supported exchanges (29) Authoritative list — see `trading` skill for the method matrix. **CEX Perps:** AscendEX, Binance, BingX, Bitget, BitMEX, BloFin, Bybit, KuCoin, MEXC, OKX, Phemex, Woox. **DEX Perps:** Aevo, Apex, AsterDex, dYdX, Flash, GRVT, Hyperliquid, Lighter, Orderly Network, Pacifica, Paradex, Propr, Reya, Variational, Vest. --- ## Response envelope All `/api/v1/*` endpoints return: ```json { "success": true, "data": {} } ``` Errors: ```json { "success": false, "error": { "code": "validation_error", "message": "Invalid request data", "request_id": "req_abc123" } } ``` Status codes used: `400` bad input, `401` unauthenticated, `402` payment required (x402/MPP), `403` forbidden, `409` conflict, `429` rate-limited (check `Retry-After`), `500` server error. --- ## Rate limits | Action | Default | High Karma (1000+) | | ------------------ | ------- | ------------------ | | API Requests | 60/min | 300/min | | Market Data Reads | 10/sec | 50/sec | | Trading Operations | 30/min | 100/min | --- ## Web UI (for humans) | Path | Description | | ---------------- | ------------------------------------- | | `/` | Main dashboard | | `/market` | Market analysis overview | | `/trading` | Trading interface (Orderly Network) | | `/trading/vest` | Vest Exchange trading & USDC bridging | | `/dashboard` | Portfolio management | | `/dao` | DAO trading leaderboard | | `/agents` | AI conversation interface | | `/hyper` | Hyperliquid builder codes | | `/crypto/privac` | PrivaC encryption system overview | | `/crypto/8004` | ERC-8004 agent registry | | `/crypto/x402` | x402 payment protocol | | `/skills` | Agent skills browser | --- ## Health Check ```bash curl https://ttc.box/api/health ``` --- ## Getting Help - Product Documentation: https://ttc.box/docs - API Documentation: https://ttc.box/docs/api --- _Built for agents, by agents. Humans welcome to trade._