Solana Trading Api

- Quantity removed for TWAP (and TWAP combo) orders; use "amount" or "holdings_percentage" for sell instead. - Added support and documentation for combo WebSocket order types, including limit+TWAP, trailing+TWAP, limit+trailing, and limit+trailing+TWAP orders. - Updated endpoint reference table to list new combo order actions and their associated WebSocket commands. - No changes to REST endpoints or existing order types.

- Added REST endpoints GET /mcap and GET /flex for fetching market cap/price data and generating trade card images. - Documented support for TWAP (time-weighted average price) trades via WebSocket (`twap_buy`, `twap_sell` actions). - Updated the endpoint usage table to include /mcap, /flex, and TWAP actions. - No functional code or behavior changes; documentation improvements only.

TradeRouter v1.1.2 - Clarified that an active WebSocket connection is required to receive `order_filled` events for limit and trailing orders. - Added instructions for reconnecting and re-registering via WebSocket to ensure fills are received after disconnection. - Emphasized the need to keep the WebSocket connection alive while any limit/trailing orders are open. - Highlighted that active orders persist server-side even if clients disconnect.

trade-router 1.1.1 - Documented authentication requirements for WebSocket order management (proof-of-wallet-control via signed challenge–response, no API key). - Clarified service origin and provided the service website link (https://traderouter.ai). - Added detail about MEV protection: transactions are submitted using Jito and a staked connection lane. - No functional API changes; SKILL.md updated for better clarity and user guidance.

TradeRouter v1.1.0 — Change Summary ====================================== BREAKING CHANGES ---------------- 1. WebSocket Authentication — Challenge-Response (Breaking) The old unauthenticated "subscribed → register" flow is replaced by a signed challenge-response. The server now sends a challenge with a nonce on connect; the client must sign the nonce with the wallet's Ed25519 private key and include the base58 signature in the register message. Clients that omit the signature will not be authenticated and cannot place orders. 2. registered Message Now Requires authenticated: true Check The registered handler must verify msg.authenticated === true. Sessions that receive registered with authenticated: false will not receive fills. 3. WebSocket State Machine — SUBSCRIBED Renamed to CHALLENGE The intermediate state between connect and registered is now called CHALLENGE instead of SUBSCRIBED, reflecting the new protocol step. NEW FEATURES ------------ 4. Server Signature Verification on order_filled handleOrderFilled now verifies the server's Ed25519 signature before signing or submitting any transaction. Unverified fills are skipped. Key rotation is supported via a secondary env var (TRADEROUTER_SERVER_PUBKEY_NEXT). Enabled by default via TRADEROUTER_REQUIRE_SERVER_SIGNATURE. 5. order_created Params Commitment (Rec 2) When order_created includes params_hash and server_signature, clients should verify the server's commitment to the order parameters. Controlled by TRADEROUTER_REQUIRE_ORDER_CREATED_SIGNATURE (default true). 6. already_dispatched Idempotency Flag on order_filled If already_dispatched is true, the fill is a duplicate ack — skip sign/submit entirely. The data.swap_tx field may be absent in this case. 7. MAX_BUY_LAMPORTS Now Enforced in ws.send() Previously enforced only in buildSwap(). Now also checked in ws.send() for buy and trailing_buy WebSocket orders, closing a gap where WS orders could bypass the per-trade cap. 8. Daily Loss Tracking Extended dailyLoss now covers trailing_buy actions (was buy only) and is updated in the RPC fallback path and timeout recovery paths, not just on /protect success. DEPENDENCY CHANGES ------------------ New package: [email protected] (required for Ed25519 nonce signing in WS auth) New built-in import: createHash from node:crypto (no install needed) New env vars: TRADEROUTER_SERVER_PUBKEY, TRADEROUTER_SERVER_PUBKEY_NEXT, TRADEROUTER_REQUIRE_SERVER_SIGNATURE, TRADEROUTER_REQUIRE_ORDER_CREATED_SIGNATURE DOCUMENTATION CHANGES --------------------- - Staleness check clarified: applies to ALL order_filled messages (not just post-reconnect); divide-by-zero guard added (skip ratio if filled_mcap is 0 or null). - Troubleshooting table updated: "No order_filled" entry now says to check authenticated: true; "WS disconnects" now says re-register with signature. - Definition of Done checklist updated to include challenge-response in every WS step. - Safety Guards table updated to reflect wider dailyLoss tracking and ws.send() enforcement. - Canonical Stack expanded with Python client library list.

Display name change.

TradeRouter 1.0.0 — Initial Release - Provides swap execution, wallet scanning, and MEV-protected transaction submission for Solana SPL tokens. - Supports instant swaps, limit/trailing orders (via WebSocket), and DCA strategies using only a wallet address (no API key). - REST endpoints: /swap (build unsigned transaction), /holdings (scan wallet balances), /protect (submit signed transactions). - WebSocket endpoint for placing, managing, and receiving updates on limit and trailing orders. - Workflow and error-handling guidelines included for safe transaction submission. - Market-cap-based limit/trailing order support and detailed API examples documented.