demerzels-lab/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.

curl -L -X GET "${MAXXIT_API_URL}/api/lazy-trading/programmatic/club-details" \
  -H "X-API-KEY: ${MAXXIT_API_KEY}"

Response:

{
  "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.

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:

{
  "message": "Your trading signal text"
}

Response:

{
  "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