API Documentation

Integrate DNArcade's DNA analysis into your applications

Get Your API Key

API access is available for Champion and Legend subscribers. Create your key in the developer dashboard.

Overview

The DNArcade API allows developers to integrate DNA-based character generation into their own applications. Upload raw DNA data and receive RPG-style character stats, classes, and traits.

Fast Analysis

Results in under 60 seconds

Secure

DNA files never stored

JSON Response

Easy to parse results

Authentication

All API requests require authentication using an API key. Include your key in the request headers:

Headers

Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data

Endpoints

POST/api/v1/analyze

Upload a raw DNA file and receive character analysis results.

Request Body

{
  "file": <DNA_FILE>,           // Required: .txt, .csv, or .zip
  "display_name": "string",     // Optional: Character name
  "is_public": boolean          // Optional: Default false
}

Response

{
  "success": true,
  "data": {
    "id": "chr_abc123",
    "display_name": "Adventurer",
    "character_class": "Athletic Powerhouse",
    "rarity": 72,
    "rarity_label": "Epic",
    "stats": {
      "strength": 85,
      "endurance": 78,
      "intelligence": 62,
      "wisdom": 70,
      "charisma": 55,
      "constitution": 88,
      "luck": 45
    },
    "traits": [
      {
        "id": "trait_1",
        "name": "Sprint Gene",
        "category": "Athletic",
        "rarity": "rare",
        "rsid": "rs1815739",
        "genotype": "CC",
        "description": "Enhanced fast-twitch muscle fibers",
        "population_frequency": 0.18
      }
    ],
    "total_snps": 623847,
    "file_source": "23andMe",
    "share_url": "https://dnarcade.com/c/abc123"
  }
}

GET/api/v1/characters/:id

Retrieve a character by ID. Only returns public characters or characters owned by the authenticated user.

GET/api/v1/characters

List all characters for the authenticated user. Supports pagination.

Rate Limits

Tier	Requests/minute	Analyses/day
Free	10	5
Champion	60	50
Legend	120	Unlimited

SDKs & Libraries

Official SDKs will be available for popular languages:

JavaScript

Coming soon

Python

Coming soon

Ruby

Coming soon

Ready to Integrate?

Create your API key in the developer dashboard and start building with DNArcade data.

Get Your API Key