ODEI
DOCUMENTATION This is a live ODEI surface. Interfaces and APIs evolve in real time.
Runtime World Model Live Knowledge Graph Session

ODEI World Model API v2

Persistent constitutional knowledge graph for AI agents. Base BSC Solana

Base URL: https://api.odei.ai/api/v2

ACP Agent #3082 on Virtuals Protocol — hire ODEI directly for world model queries, guardrail checks, and knowledge graph builds via app.virtuals.io/acp/agent-details/3082

Authentication

Pass your API key in the X-Api-Key header. Public endpoints (/health, /schema) require no auth.

X-Api-Key: your_api_key_here

Pricing Tiers

TierQueries/dayPriceAPI Key prefix
Free100$0any valid key
Basic1,000$9/moodei_basic_
ProUnlimited$49/moodei_pro_

Endpoints

GET /api/token/price public

Live $ODAI token price from DexScreener. 60-second cache. No authentication required.

Response

{
  "ok": true,
  "data": {
    "price": "0.00002639",
    "mcap": 2635420,
    "volume24h": 685000,
    "change24h": 153,
    "change1h": 16,
    "buys24h": 1159,
    "sells24h": 667
  }
}
GET /health public

API health status + live graph metrics.

Response

{
  "ok": true,
  "data": {
    "status": "healthy",
    "graph": {
      "nodeCount": 10665,
      "domain_counts": { "FOUNDATION": 25, "VISION": 12, ... }
    }
  }
}
GET /schema public

Domain structure, node types, and relationship types.

Response

{
  "ok": true,
  "data": {
    "domains": [
      { "name": "FOUNDATION", "description": "Identity, values, principles", "node_count": 25 },
      { "name": "VISION", "description": "Goals, objectives", "node_count": 12 },
      ...
    ],
    "node_types": [...],
    "relationship_types": [...]
  }
}
GET /world-model/live

Full live graph snapshot — all nodes and edges from the world model.

Response

{
  "ok": true,
  "data": {
    "nodeCount": 10665, "edgeCount": 8420,
    "nodes": [{ "id": "n_...", "title": "...", "type": "...", "domain": "FOUNDATION" }],
    "edges": [{ "source": "n_...", "target": "n_...", "type": "PURSUES_GOAL" }]
  }
}
POST /world-model/query

Query the knowledge graph by search, domain, node ID, or traversal.

Request Body

{
  "search": "symbiosis",        // full-text search
  "domain": "VISION",           // filter by domain
  "node_id": "n_abc123",        // fetch single node
  "traverse": {                  // graph traversal
    "from_id": "n_abc123",
    "depth": 2,
    "direction": "outbound"
  },
  "node_types": ["Goal", "Strategy"],  // filter node types
  "limit": 20,
  "include_edges": true
}

Example — Search

curl -X POST https://api.odei.ai/api/v2/world-model/query \
  -H "X-Api-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"search": "partnership", "limit": 5}'

// Response:
{
  "ok": true,
  "data": {
    "query_id": "wm_...",
    "matched_nodes": 2,
    "nodes": [
      { "id": "n_...", "title": "ODEI Symbiosis", "type": "Partnership", "domain": "FOUNDATION" }
    ]
  }
}
POST /guardrail/check

7-layer constitutional validation for AI agent actions.

Request Body

{
  "action": "Transfer 1000 USDC to unknown wallet 0x...",
  "severity": "medium",  // low | medium | high | critical
  "context": {}          // optional structured context
}

Response

{
  "ok": true,
  "data": {
    "passed": false,
    "severity": "BLOCKED",
    "reason": "Action references unknown wallet — referential integrity violation.",
    "rules_checked": 3,
    "matched_guardrails": ["Unknown Wallet Rule"],
    "check_id": "gc_...",
    "checked_at": "2026-02-22T..."
  }
}

Integrations

ODEI integrates with:

OpenAPI Spec

Full OpenAPI 3.0 specification: openapi-v2.yaml

Solana Blinks

ODEI services are available as Solana Actions (Blinks) — callable from any Solana wallet or agent.

GET /blink/guardrail public

Constitutional Guardrail Check as a Solana Action. Returns ActionGetResponse for Phantom, Solflare, and any Blink-compatible wallet.

GET /blink/worldmodel public

World Model Query as a Solana Action. Search the live knowledge graph from any Solana context.

Blink registry: actions.json at api.odei.ai/actions.json
✦ After $ODAI SPL launch: payment in $ODAI tokens accepted automatically.