Developer API

API Documentation

Integrate MathBeast's AI-powered math problem solving into your applications with our comprehensive REST API.

Developer API & Integration

Access structured math data programmatically. Powered by GPT-OSS-120B inspired architecture with chain-of-thought reasoning and adaptive learning capabilities.

Chain-of-ThoughtBatch ProcessingStreamingCompetition MathAdaptive Learning

Problems API

Access structured math problems with metadata, difficulty ratings, and competition levels

GET /api/problems
?topic=algebra
&difficulty=intermediate
&limit=10

Classification API

AI-powered problem classification with topic detection, difficulty assessment, and prerequisite mapping

POST /api/classify
{
  "content": "Prove √2 is irrational",
  "source": "competition"
}

Solution Generation

Generate step-by-step solutions with chain-of-thought reasoning and verification

POST /api/solutions
{
  "problemId": "abc123",
  "reasoningLevel": "high",
  "includeAlternatives": true
}

Hints API

Progressive hint system with 3 levels - from subtle nudges to detailed guidance

POST /api/hints
{
  "problemId": "abc123",
  "hintLevel": 2,
  "currentStep": 1
}

Batch Processing

Process up to 100 problems concurrently with job status tracking

POST /api/batch
{
  "problems": [
    {"content": "...", "source": "..."}
  ]
}

Adaptive Difficulty

AI-driven difficulty recommendations based on student performance patterns

POST /api/adaptive
{
  "userId": "user123",
  "recentPerformance": [...]
}

Model Configuration

Get current model configuration, capabilities, and real-time processing statistics.

GET /api/config

Response:
{
  "model": {
    "modelId": "anthropic/claude-sonnet-4-20250514",
    "reasoningLevel": "medium",
    "useChainOfThought": true
  },
  "capabilities": {
    "maxBatchSize": 100,
    "reasoningLevels": ["low", "medium", "high"],
    "hintLevels": [1, 2, 3]
  },
  "stats": {
    "problemsProcessed": 15420,
    "solutionsGenerated": 8750,
    "cacheHits": 12300
  }
}

Quick Start

1. Get Your API Key

2. Make Your First Request

curl -X POST https://api.mathbeast.ai/v1/solve \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"problem": "Solve x^2 - 5x + 6 = 0"}'

3. Get AI-Powered Solutions

Receive step-by-step solutions with chain-of-thought reasoning, hints, and explanations.

Ready to Build?

Check the API status or explore the AI model behind our solutions.