Getting Started - DITO FORGE

1

Create Your Account

Sign up for a DITO developer account to get your API credentials.

📧 Account Benefits

Get access to the full DITO ecosystem including talent management APIs, arena events, and ember economy integration.

🔥

Sign Up

Create your DITO account

🔑

Login

Already have an account?

2

Get Your API Key

Once logged in, navigate to your developer dashboard to generate your API key.

Generate API Key

Go to Settings → API Keys → Generate New Key

⚠️ Keep Your Key Secure

Store your API key safely. Never commit it to version control or share it publicly. Use environment variables in production.

Environment Setup

bash

# Add to your .env file
DITO_API_KEY=your_api_key_here
DITO_BASE_URL=https://api.dito.guru

3

Choose Your Integration Method

Select the integration approach that best fits your project:

📦

TypeScript SDK

Type-safe SDK with full IntelliSense support

🤖

OpenClaw Agent

Natural language AI agent integration

🧠

Claude Functions

Function calling for conversational AI

🌐

Raw HTTP API

Direct REST API integration

4

Install and Setup

TypeScript/JavaScript Projects

bash

# Install the SDK
npm install @dito/sdk

# Or with yarn
yarn add @dito/sdk

# Or with pnpm
pnpm add @dito/sdk

Basic Setup

TypeScript

import { DitoClient } from '@dito/sdk';

const dito = new DitoClient({
  apiKey: process.env.DITO_API_KEY!,
  baseURL: 'https://api.dito.guru'
});

export default dito;

OpenClaw Integration

Python

import requests
import os

def dito_command(action: str, **kwargs) -> dict:
    """Execute DITO talent management commands"""
    
    api_key = os.getenv('DITO_API_KEY')
    headers = {'Authorization': f'Bearer {api_key}'}
    
    payload = {'action': action, **kwargs}
    
    response = requests.post(
        'https://api.dito.guru/command',
        json=payload,
        headers=headers
    )
    
    return response.json()

5

Make Your First Request

Test your integration with a simple API call to get your soul information.

Using TypeScript SDK

TypeScript

import dito from './dito-client';

async function main() {
  try {
    // Get your soul information
    const soul = await dito.souls.getSoul();
    console.log(`Welcome ${soul.seeker_name}!`);
    console.log(`Current stage: ${soul.current_level}`);
    console.log(`Ember points: ${soul.ember_points}`);
    
    // List available talents
    const talents = await dito.talents.listTalents();
    console.log(`Available talents: ${talents.length}`);
    
  } catch (error) {
    console.error('Error:', error);
  }
}

main();

Using Raw HTTP

bash

curl -X POST https://api.dito.guru/command \
  -H "Authorization: Bearer $DITO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action": "get_soul"}'

Expected Response

JSON

{
  "success": true,
  "data": {
    "id": "your-soul-id",
    "seeker_name": "Your Name",
    "current_level": "Flame",
    "ember_points": 1250,
    "total_talents": 5,
    "active_talents": 2,
    "arena_eligible": true
  },
  "message": "Soul information retrieved successfully",
  "meta": {
    "timestamp": "2026-03-16T10:30:00Z",
    "request_id": "req_12345",
    "version": "1.0.0"
  }
}