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:

Name	Type	Description
`prompt`	string	The input prompt for the models
`mode`	string	`random`, `topper`, or `manual`
`models`	array	(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

Getting Started

Concepts

Platform

API Reference

DualMind Arena API

Authentication

Base URL

Comparisons

Submit a Prompt

Voting

Submit a Vote

Models & Stats

List Models

Get Leaderboard

​DualMind Arena API

​Authentication

​Base URL

​Comparisons

​Submit a Prompt

​Voting

​Submit a Vote

​Models & Stats

​List Models

​Get Leaderboard

DualMind Arena API

Authentication

Base URL

Comparisons

Submit a Prompt

Voting

Submit a Vote

Models & Stats

List Models

Get Leaderboard