Skip to main content

​
DualMind Arena API

The DualMind Arena API allows you to programmatically:
  • Submit prompts to the arena
  • Retrieve anonymized model responses
  • Vote on comparisons
  • Access the public leaderboard data

​
Authentication

All API requests require an authentication token. You can obtain a personal access token from your account settings. 
Authorization: Bearer <your_api_token>

​
Base URL

All requests should be made to: 
https://api.dualmind.ai/v1

​
Comparisons

​
Submit a Prompt

Run a blind comparison between two models. 
POST /arena/compare
Parameters:
NameTypeDescription
promptstringThe input prompt for the models
modestringrandom, topper, or manual
modelsarray(Optional) Specific model IDs if using manual mode
Response: 
{
  "comparisonId": "cmp_12345",
  "responses": [
    {
      "modelId": "hidden",
      "content": "Response from Model A..."
    },
    {
      "modelId": "hidden",
      "content": "Response from Model B..."
    }
  ]
}

​
Voting

​
Submit a Vote

Cast your vote for the better response. This reveals the model identities. 
POST /arena/vote
Body: 
{
  "comparisonId": "cmp_12345",
  "winner": "left" // "left", "right", "tie", or "both_bad"
}
Response: 
{
  "success": true,
  "revealedModels": {
    "left": {
      "id": "gpt-4o",
      "name": "GPT-4o"
    },
    "right": {
      "id": "claude-3-5-sonnet",
      "name": "Claude 3.5 Sonnet"
    }
  }
}

​
Models & Stats

​
List Models

Get the current list of available models and their ELO ratings. 
GET /models

​
Get Leaderboard

Retrieve the current global leaderboard. 
GET /leaderboard