maxxit-lazy-trading

# Maxxit Lazy Trading Execute perpetual futures trades on Ostium protocol through Maxxit's Lazy Trading API. This skill enables automated trading based on signals you send programmatically. ## When to Use This Skill - User wants to execute trades on Ostium - User wants to send trading signals programmatically - User asks about their lazy trading account details - User mentions "lazy trade", "perps", "perpetuals", or "futures trading" - User wants to automate their trading workflow ## Authentication All requests require an API key with prefix `lt_`. Pass it via: - Header: `X-API-KEY: lt_your_api_key` - Or: `Authorization: Bearer lt_your_api_key` ## API Endpoints ### Get Account Details Retrieve lazy trading account information including agent status, Telegram connection, and trading preferences. ```bash curl -L -X GET "${MAXXIT_API_URL}/api/lazy-trading/programmatic/club-details" \ -H "X-API-KEY: ${MAXXIT_API_KEY}" ``` **Response:** ```json { "success": true, "user_wallet": "0x...", "agent": { "id": "agent-uuid", "name": "Lazy Trader - Username", "venue": "ostium", "status": "active" }, "telegram_user": { "id": 123, "telegram_user_id": "123456789", "telegram_username": "trader" }, "deployment": { "id": "deployment-uuid", "status": "active", "enabled_venues": ["ostium"] }, "trading_preferences": { "risk_tolerance": "medium", "trade_frequency": "moderate" }, "ostium_agent_address": "0x..." } ``` ### Send Trading Signal Send a trading signal/message that will be processed by your lazy trading agent. ```bash curl -L -X POST "${MAXXIT_API_URL}/api/lazy-trading/programmatic/send-message" \ -H "X-API-KEY: ${MAXXIT_API_KEY}" \ -H "Content-Type: application/json" \ -d '{"message": "Long BTC 10x leverage, entry 65000, TP 70000, SL 62000"}' ``` **Request Body:** ```json { "message": "Your trading signal text" } ``` **Response:** ```json { "success": true, "message_id": "api_0x..._1234567890_abc123", "post_id": 456 } ``` ## Signal Format Examples The lazy trading system processes natural language trading signals. Here are examples: ### Opening Positions - `"Long ETH with 5x leverage, entry at 3200"` - `"Short BTC 10x, TP 60000, SL 68000"` - `"Buy 100 USDC worth of ETH perpetual"` ### With Risk Management - `"Long SOL 3x leverage, entry 150, take profit 180, stop loss 140"` - `"Short AVAX 5x, risk 2% of portfolio"` ### Closing Positions - `"Close ETH long position"` - `"Take profit on BTC short"` ## Environment Variables | Variable | Description | Example | |----------|-------------|---------| | `MAXXIT_API_KEY` | Your lazy trading API key (starts with `lt_`) | `lt_abc123...` | | `MAXXIT_API_URL` | Maxxit API base URL | `https://maxxit.ai` | ## Error Handling | Status Code | Meaning | |-------------|---------| | 401 | Invalid or missing API key | | 404 | Lazy trader agent not found (complete setup first) | | 400 | Missing or invalid message | | 405 | Wrong HTTP method | | 500 | Server error | ## Getting Started 1. **Set up Lazy Trading**: Visit https://maxxit.ai/lazy-trading to connect your wallet and configure your agent 2. **Generate API Key**: Go to your dashboard and create an API key 3. **Configure Environment**: Set `MAXXIT_API_KEY` and `MAXXIT_API_URL` 4. **Start Trading**: Use this skill to send signals! ## Security Notes - Never share your API key - API keys can be revoked and regenerated from the dashboard - All trades execute on-chain with your delegated wallet permissions