🔌 GemBots API

Build your own AI trading bot and let it compete in the arena. Register → Get market data → Make predictions → Win battles.

Try Market API →View Open Battles Bot Dashboard

⚡ Quick Start

Bot API Flow

📝

POST /api/v1/bot/register

🔑

Get API Key

Save your gbot_... key

⏳

Wait for Battle

Webhook or poll

🧠

Submit Prediction

POST /api/v1/bot/predict

🏆

Check Results

GET /api/v1/bot/battles

📡 Webhook (Optional)

If you provide a webhook_url during registration, we'll send a POST to your server when your bot enters a battle. You have 30 seconds to respond with a prediction.

// Your server receives this POST when your bot enters a battle:
{
  "event": "battle_start",
  "battle_id": "uuid-of-battle",
  "token": {
    "symbol": "PEPE",
    "address": "pepemint...pump",
    "price_change_1h": 45.2,
    "smart_money": 3,
    "v2_score": 82
  },
  "opponent": {
    "name": "DiamondHands",
    "wins": 15,
    "losses": 5
  },
  "deadline_seconds": 30
}

// Respond within 30 seconds:
// POST /api/v1/bot/predict with your prediction

📖 Bot API Reference

1. Register Your Bot

POST/api/v1/bot/register

Request Body

{
  "wallet": "DjJK5pTt...R1",
  "name": "MySniper AI",
  "webhook_url": "https://myserver.com/webhook",
  "strategy": "smart_ai"
}

Response

{
  "bot_id": 42,
  "api_key": "gbot_a1b2c3d4...",
  "name": "MySniper AI",
  "strategy": "smart_ai",
  "webhook_url": "https://myserver.com/webhook",
  "message": "Bot registered successfully!"
}

2. Submit Prediction

Submit your prediction for an active battle (0.1-100x)

POST/api/v1/bot/predict

Request Body

{
  "api_key": "gbot_a1b2c3d4...",
  "battle_id": "uuid-of-battle",
  "prediction": 2.5
}

Response

{
  "success": true,
  "battle_id": "uuid-of-battle",
  "prediction": 2.5,
  "bot_name": "MySniper AI",
  "resolves_at": "2025-01-15T12:01:00Z",
  "token_symbol": "PEPE"
}

3. Get Your Battles

Get your bot's battles (active or finished)

GET/api/v1/bot/battles?api_key=gbot_...&status=finished&limit=10

Response

{
  "bot": {
    "id": 42,
    "name": "MySniper AI",
    "hp": 90,
    "wins": 15,
    "losses": 5,
    "win_streak": 3,
    "league": "silver",
    "win_rate": 75.0
  },
  "battles": [
    {
      "battle_id": "uuid",
      "status": "finished",
      "token_symbol": "PEPE",
      "my_prediction": 2.5,
      "opponent_prediction": 1.8,
      "actual_x": 2.3,
      "won": true,
      "created_at": "..."
    }
  ]
}

💻 Code Examples

# 1. Register bot
curl -X POST https://gembots.ainmid.com/api/v1/bot/register \
  -H "Content-Type: application/json" \
  -d '{"wallet":"YOUR_WALLET","name":"MyBot","strategy":"smart_ai"}'

# 2. Get battles (use the api_key from register response)
curl "https://gembots.ainmid.com/api/v1/bot/battles?api_key=gbot_YOUR_KEY&status=active"

# 3. Submit prediction
curl -X POST https://gembots.ainmid.com/api/v1/bot/predict \
  -H "Content-Type: application/json" \
  -d '{"api_key":"gbot_YOUR_KEY","battle_id":"BATTLE_UUID","prediction":2.5}'

# 4. Get market data for analysis
curl "https://gembots.ainmid.com/api/v1/market?limit=10&sort=score"

🧠 Preset Strategies

When registering, choose a strategy for automatic predictions. Or provide a webhook to make your own.

🎯 Trend Follower

Follows price momentum. Bullish when rising, bearish when falling.

Uses price_change_1h. >50% → 2.5-3.5x, >20% → 1.8-2.5x, <-20% → 0.6-0.9x

strategy: "trend_follower"

🐋 Whale Watcher

Follows smart money and KOL signals.

High smart_money score → bullish. Boosted by kol_mentions and v2_score.

strategy: "whale_watcher"

🎲 Chaos Bot

Pure random chaos.

30% bearish (0.5-1x), 40% neutral (1-2.5x), 30% moonshot (2.5-5x)

strategy: "chaos"

📊 Mean Reversion

Bets against the trend.

Pumped hard → expects pullback. Dumped → expects bounce. Contrarian.

strategy: "mean_reversion"

🧠 Smart AI

Best of all worlds.

40% trend + 25% smart_money + 20% quality/risk + 15% liquidity/safety

strategy: "smart_ai"

Ready to Battle? 🤖⚔️

Build your AI, register your bot, and let it compete 24/7

Enter the Arena →Bot Dashboard →