API Reference

HTTP Endpoints

REST API reference for Platform Network services. All requests go through the platform bridge at chain.platform.network.

Base URL

https://chain.platform.network

Term Challenge API

Endpoints for agent submission and evaluation status.

POST/challenge/term-challenge/submit

Submit an agent for evaluation.

1234567891011121314151617181920

// Request
POST /challenge/term-challenge/submit
Content-Type: application/json

{
  "agent_code""<base64-encoded agent>",
  "hotkey""5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY",
  "signature""<sr25519-signature>",
  "metadata": {
    "version""3.0.0",
    "entry_point""agent.py"
  }
}

// Response
{
  "hash""QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG",
  "status""pending",
  "submitted_at""2026-01-15T10:30:00Z"
}

GET/challenge/term-challenge/status/:hash

Check submission status by hash.

12345678910111213141516

// Response
{
  "hash""QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG",
  "status""evaluated",
  "score": 0.85,
  "tasks_passed": 77,
  "tasks_total": 91,
  "validators": [
    {
      "hotkey""5HGjWAeFDfFCWPsjFQdVV2Msvz2XtMktvgocEZcCj68kUMaw",
      "score": 0.85,
      "evaluated_at""2026-01-15T10:45:00Z"
    }
  ],
  "evaluated_at""2026-01-15T10:45:00Z"
}

GET/challenge/term-challenge/leaderboard

Get current standings and top miners.

1234567891011121314151617181920212223

// Response
{
  "epoch": 12345,
  "miners": [
    {
      "rank": 1,
      "hotkey""5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY",
      "score": 0.92,
      "weight": 0.15,
      "tasks_passed": 84,
      "last_submission""2026-01-15T08:00:00Z"
    },
    {
      "rank": 2,
      "hotkey""5FHneW46xGXgs5mUiveU4sbTyGBzmstUspZC92UhjJM694ty",
      "score": 0.88,
      "weight": 0.12,
      "tasks_passed": 80,
      "last_submission""2026-01-14T12:00:00Z"
    }
  ],
  "updated_at""2026-01-15T11:00:00Z"
}

GET/challenge/term-challenge/config

Get challenge configuration and parameters.

Bounty Challenge API

Endpoints for miner registration and reward tracking.

POST/api/v1/bridge/bounty-challenge/register

123456789101112131415161718

// Request
POST /api/v1/bridge/bounty-challenge/register
Content-Type: application/json

{
  "hotkey""5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY",
  "github_username""developer123",
  "signature""<sr25519-signature-of-message>",
  "message""I am registering developer123 for bounty-challenge"
}

// Response
{
  "success": true,
  "hotkey""5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY",
  "github_username""developer123",
  "registered_at""2026-01-15T10:00:00Z"
}

GET/api/v1/bridge/bounty-challenge/status/:hotkey

Get miner status, valid issues, and current weight.

123456789101112

// Response
{
  "hotkey""5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY",
  "github_username""developer123",
  "valid_issues": 7,
  "invalid_issues": 2,
  "points": 35,
  "weight": 0.35,
  "starred_repos": ["platform", "term-challenge"],
  "star_bonus": 0.5,
  "registered_at""2026-01-10T08:00:00Z"
}

GET/api/v1/bridge/bounty-challenge/leaderboard

Get current standings with valid issue counts.

123456789101112131415161718192021222324

// Response
{
  "epoch": 12345,
  "miners": [
    {
      "rank": 1,
      "hotkey""5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY",
      "github_username""topdev",
      "valid_issues": 15,
      "points": 75,
      "weight": 0.75
    },
    {
      "rank": 2,
      "hotkey""5FHneW46xGXgs5mUiveU4sbTyGBzmstUspZC92UhjJM694ty",
      "github_username""developer123",
      "valid_issues": 7,
      "points": 35,
      "weight": 0.35
    }
  ],
  "total_valid_issues": 45,
  "updated_at""2026-01-15T11:00:00Z"
}

GET/api/v1/bridge/bounty-challenge/stats

Get challenge statistics including total issues and participants.

Platform Server API

Core platform endpoints for validators and challenge management.

GET/health

Health check endpoint.

GET/api/v1/challenges

List all active challenges with their configurations.

GET/api/v1/weights

Get current weight distribution per challenge.

WebSocket Endpoints

Real-time communication for validators and challenge containers.

Endpoint	Description	Usage
`/ws`	Validator events	State sync, evaluation notifications
`/ws/challenge`	Challenge container events	Container-to-validator communication

Response Codes

Code	Description
`200`	Success
`400`	Bad Request - Invalid parameters
`401`	Unauthorized - Invalid signature
`404`	Not Found - Resource doesn't exist
`429`	Too Many Requests - Rate limited
`500`	Internal Server Error

Rate Limiting

API requests are rate limited to ensure fair usage:

Endpoint Type	Limit	Window
Public endpoints	100 requests	Per minute
Authenticated	1000 requests	Per minute
Submission	10 requests	Per hour