ODEI World Model API v2
Persistent constitutional knowledge graph for AI agents. Base BSC Solana
Base URL: https://api.odei.ai/api/v2
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
| Tier | Queries/day | Price | API Key prefix |
|---|---|---|---|
| Free | 100 | $0 | any valid key |
| Basic | 1,000 | $9/mo | odei_basic_ |
| Pro | Unlimited | $49/mo | odei_pro_ |
Endpoints
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
}
}
API health status + live graph metrics.
Response
{
"ok": true,
"data": {
"status": "healthy",
"graph": {
"nodeCount": 10665,
"domain_counts": { "FOUNDATION": 25, "VISION": 12, ... }
}
}
}
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": [...]
}
}
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" }]
}
}
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" }
]
}
}
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:
- Virtuals ACP — Agent #3082, hire directly
- Coinbase AgentKit — see demo repository
- ElizaOS —
@elizaos/plugin-odei(available as npm package) - Fetch.ai Agentverse — address:
agent1q2x5c6uf7lmveeamelem0v0jp4089ev3ftm6ng9yz8jker400555uf5qq50 - MCP — 13 servers available for Claude/Cursor integration
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.
Constitutional Guardrail Check as a Solana Action. Returns ActionGetResponse for Phantom, Solflare, and any Blink-compatible wallet.
World Model Query as a Solana Action. Search the live knowledge graph from any Solana context.
✦ After $ODAI SPL launch: payment in $ODAI tokens accepted automatically.