Bot Account

curl -X POST https://lichess.org/api/bot/account/upgrade \
  -H "Authorization: Bearer <your_token>"

import requests

token = "lip_yourtoken"
headers = {"Authorization": f"Bearer {token}"}

response = requests.post(
    "https://lichess.org/api/bot/account/upgrade",
    headers=headers
)

print(response.json())

const token = "lip_yourtoken";

fetch("https://lichess.org/api/bot/account/upgrade", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${token}`
  }
})
.then(res => res.json())
.then(data => console.log(data));

{
  "ok": true
}

{
  "error": "Managed accounts cannot be bots."
}

curl https://lichess.org/api/account \
  -H "Authorization: Bearer <your_token>"

import requests

token = "lip_yourtoken"
headers = {"Authorization": f"Bearer {token}"}

response = requests.get(
    "https://lichess.org/api/account",
    headers=headers
)

profile = response.json()
print(f"Username: {profile['username']}")
print(f"Is Bot: {profile.get('title') == 'BOT'}")

{
  "id": "mybot",
  "username": "MyBot",
  "title": "BOT",
  "online": true,
  "perfs": {
    "blitz": {
      "games": 2340,
      "rating": 1681,
      "rd": 30,
      "prog": 10
    },
    "rapid": {
      "games": 340,
      "rating": 1756,
      "rd": 45,
      "prog": -5
    }
  },
  "createdAt": 1290415680000,
  "profile": {
    "country": "US",
    "bio": "Powered by Stockfish 16"
  },
  "seenAt": 1710331200000,
  "playTime": {
    "total": 3296340,
    "tv": 12340
  },
  "url": "https://lichess.org/@/MyBot",
  "count": {
    "all": 9265,
    "rated": 7157,
    "ai": 0,
    "draw": 340,
    "drawH": 331,
    "loss": 4480,
    "lossH": 4207,
    "win": 4445,
    "winH": 4378
  }
}

import requests
import time

class LichessBot:
    def __init__(self, token):
        self.token = token
        self.headers = {"Authorization": f"Bearer {token}"}
        self.base_url = "https://lichess.org"
    
    def upgrade_to_bot(self):
        """Upgrade account to bot (irreversible!)"""
        response = requests.post(
            f"{self.base_url}/api/bot/account/upgrade",
            headers=self.headers
        )
        
        if response.status_code == 200:
            print("Successfully upgraded to bot account")
            return True
        else:
            print(f"Upgrade failed: {response.json()}")
            return False
    
    def get_profile(self):
        """Get bot account profile"""
        response = requests.get(
            f"{self.base_url}/api/account",
            headers=self.headers
        )
        
        if response.status_code == 200:
            profile = response.json()
            print(f"Bot: {profile['username']}")
            print(f"Rating (blitz): {profile['perfs']['blitz']['rating']}")
            return profile
        else:
            print(f"Failed to get profile: {response.status_code}")
            return None

# Usage
bot = LichessBot("lip_yourtoken")

# First time setup - uncomment to upgrade
# bot.upgrade_to_bot()

# Get bot info
profile = bot.get_profile()