AI-Powered
Blockchain-Authenticated

API Documentation

Integrate with our powerful gaming platform using our comprehensive API

API Endpoints

GET Health Check

/health

Check if the API is running and get the current server time.

Response:

POST Generate Character

/characters/generate

Generate a single character with specific theme and role.

Request Body:
{
    "themeStyle": "fantasy",
    "preferredRole": "tank"
}
Response:

POST Generate Multiple Characters

/characters/generate-multiple

Generate multiple characters with different themes and roles.

Request Body:
{
    "characters": [
        {
            "themeStyle": "fantasy",
            "preferredRole": "tank"
        },
        {
            "themeStyle": "cyberpunk",
            "preferredRole": "assassin"
        }
    ]
}
Response:

POST Generate Team

/characters/generate-team

Generate a balanced team of characters.

Request Body:
{
    "teamSize": 4,
    "teamParams": {
        "themeStyle": "mixed",
        "balanceRoles": true
    }
}
Response:

POST Simulate Tournament

/tournament/simulate

Simulate a tournament with multiple players.

Request Body:
{
    "players": [
        {
            "characterName": "Dragon Knight",
            "attributes": {
                "attack": 75,
                "defense": 60,
                "speed": 45,
                "maxHP": 150,
                "specialAbilities": ["Slash", "Battle Cry", "Combat Mastery"]
            }
        },
        {
            "characterName": "Shadow Assassin",
            "attributes": {
                "attack": 85,
                "defense": 40,
                "speed": 80,
                "maxHP": 120,
                "specialAbilities": ["Slash", "Battle Cry", "Combat Mastery"]
            }
        }
    ]
}
Response:

POST Simulate Round

/tournament/simulate-round

Simulate a battle between two characters.

Request Body:
{
    "player1": {
        "characterName": "Dragon Knight",
        "attributes": {
            "attack": 75,
            "defense": 60,
            "speed": 45,
            "maxHP": 150,
            "specialAbilities": ["Slash", "Battle Cry", "Combat Mastery"]
        }
    },
    "player2": {
        "characterName": "Shadow Assassin",
        "attributes": {
            "attack": 85,
            "defense": 40,
            "speed": 80,
            "maxHP": 120,
            "specialAbilities": ["Slash", "Battle Cry", "Combat Mastery"]
        }
    }
}
Response: