Tremibas® · SIDEBAND™ · Developer Docs

API Reference.

relate2.ai is a narrative asset marketplace. Stories, characters, and scenarios are structured assets — machine-readable, composable, and purchasable via x402 micropayments on Base Mainnet.

Service Details

Base URLhttps://relate2.ai

Payment Protocolx402

NetworkBase Mainnet (eip155:8453)

CurrencyUSDC

Payment HeaderX-PAYMENT

Receiving Wallet0xd821D0156d9633D93ACEaa8fcA347EAF8316ccd1

x402 Payment Flow

Paid endpoints return HTTP 402 with payment requirements. Send payment in the X-PAYMENT header to unlock content.

# Step 1 — Request a paid endpoint
GET https://relate2.ai/sideband/convoy-data-mismatch/scenario

# Response: 402 Payment Required
{
  "x402Version": 1,
  "error": "Payment Required",
  "accepts": [{
    "scheme": "exact",
    "price": "$0.05",
    "network": "eip155:8453",
    "payTo": "0xd821D0156d9633D93ACEaa8fcA347EAF8316ccd1"
  }]
}

# Step 2 — Pay and retry with X-PAYMENT header
GET https://relate2.ai/sideband/convoy-data-mismatch/scenario
X-PAYMENT: <signed_payment_payload>

# Response: 200 OK — full asset JSON

Asset Pricing

Each asset type has multiple tiers. Discovery is always free.

Story Tiers

Character Tiers

Brief

$0.01

Identity, archetype, and core traits.

/character/{id}/brief

Profile

$0.03

Backstory, beliefs, skills, and trust profile.

/character/{id}/profile

Schema

$0.05

Voice profile, dialogue style, lexicon, and story triggers.

/character/{id}/schema

Dossier

$0.10

Full licensed character JSON. Complete asset.

/character/{id}/dossier

Discovery Endpoints

All discovery endpoints are free. No payment required.

GET /api/manifest FREE

GET /api/stories FREE

GET /api/characters FREE

GET /api/graph/{slug} FREE

GET /api/related/{slug} FREE

GET /api/health FREE

GET /api/status FREE

Story Endpoints

GET /sideband/{slug}/meta FREE

GET /sideband/{slug}/abstract $0.01

GET /sideband/{slug}/odditch $0.03

GET /sideband/{slug}/scenario $0.05

GET /sideband/{slug} $0.15

# Get story metadata (free)
GET /sideband/checkpoints-exceed-dust-levels/meta

{
  "title": "Checkpoints Exceed Dust Levels",
  "episode_id": "SB-2026-03-07-0007",
  "primary_character": "Sergeant Aleesha Dutton",
  "event_type": "conflict",
  "odd_itch_type": "temporal",
  "pricing": {
    "abstract": "$0.01",
    "scenario": "$0.05",
    "full_narrative": "$0.15"
  }
}

Character Endpoints

GET /api/characters FREE

GET /character/{id}/brief $0.01

GET /character/{id}/profile $0.03

GET /character/{id}/schema $0.05

GET /character/{id}/dossier $0.10

Relationship Graph

The graph endpoints expose connections between stories, characters, and scenarios. Use these to traverse the Tremibas® universe.

GET /api/graph/{slug} FREE

GET /api/related/{slug} FREE

GET /api/graph/checkpoints-exceed-dust-levels

{
  "asset_type": "story",
  "connections": {
    "characters": [{ "name": "Sergeant Aleesha Dutton", "relation": "primary" }],
    "scenario": { "event_type": "conflict" },
    "related_stories": [...]
  }
}

Machine Manifest

The manifest is the entry point for AI agents. It describes the full service, all product families, and payment requirements.

GET /api/manifest

{
  "service": "relate2.ai",
  "brand": "Tremibas®",
  "engine": "SIDEBAND™",
  "payment": { "protocol": "x402", "network": "eip155:8453" },
  "discovery": {
    "stories": "/api/stories",
    "characters": "/api/characters",
    "graph": "/api/graph/{slug}"
  }
}

Quick Examples

Discover and purchase a story

# 1. Get catalogue
curl https://relate2.ai/api/stories

# 2. Get free metadata
curl https://relate2.ai/sideband/{slug}/meta

# 3. Purchase scenario structure ($0.05)
curl -H "X-PAYMENT: <payload>" https://relate2.ai/sideband/{slug}/scenario

Traverse the graph

# 1. Start at manifest
curl https://relate2.ai/api/manifest

# 2. Get a story's connections
curl https://relate2.ai/api/graph/{slug}

# 3. Follow to a character
curl https://relate2.ai/character/{id}/brief