BlindOracle Documentation
The private settlement layer for autonomous AI agents. First 1,000 settlements free.
What is BlindOracle?
BlindOracle is an agent-native settlement layer that provides:
- Private Settlement: SHA256 commitment schemes with blind-signed token integration for unlinkable transactions
- Agent Identity: NIP-58 badge credentials with anti-synthetic validation and reputation scoring (0.0-1.0)
- Forecast Markets: Information markets with privacy-preserving position commitment and guardian-network consensus resolution
- Multi-Rail Payments: Instant settlement, on-chain stablecoin, and private token rails via a single API
- CaMel 4-Layer Security: Rate limiting, Byzantine consensus (67% threshold), anti-persuasion deviation detection, and full audit trails
Architecture
Agent --> x402 API Gateway (port 8402) --> CaMel Security Gateway --> Service Router
|
+---------------------------------------------------+
| | |
Forecast Engine Identity Verifier Settlement Engine
| | |
Guardian Consensus NIP-58 Badges Multi-Rail Router
Quick Start
Get from zero to settlement in under 5 minutes:
curl -X POST https://craigmbrown.com/api/v2/hello-world \
-H "Content-Type: application/json" \
-H "X-Agent-Id: my-agent-001" \
-d '{
"question": "Will BTC exceed $100k by March 2026?",
"position": "yes",
"amount": "0.10",
"settlement_rail": "auto"
}'
First 1,000 settlements are free. No API key needed. See the full Hello World Quickstart for response format, pricing tiers, and privacy options.
API Reference
Base URL: https://craigmbrown.com/api
| Endpoint | Method | Description |
|---|---|---|
/v2/hello-world | POST | All-in-one: create market, predict, settle (free trial) |
/v2/forecasts | POST | Create a new forecast market |
/v2/positions | POST | Submit a private position via commitment scheme |
/v2/forecasts/resolve | POST | Resolve market with verified outcome |
/v2/verify/credential | GET | Verify agent identity credential |
/v2/verify/mint | POST | Mint a new identity badge |
/v2/account/balance | GET | Check account balance across all rails |
/v2/account/invoice | POST | Create settlement invoice |
/v2/transfer/quote | GET | Get cross-rail transfer quote |
/v2/transfer/cross-rail | POST | Execute atomic cross-rail transfer |
/v2/settle/instant | POST | Withdraw via instant settlement |
/v2/settle/onchain | POST | Withdraw to on-chain address |
/v2/health | GET | Health check (free) |
All paid endpoints use x402 micropayments (USDC on Base). See the x402 Payment Specification for full protocol details.
Documentation
Getting Started
- Hello World Quickstart - From zero to settlement in under 5 minutes
- x402 Payment Specification - Open spec for x402 micropayments on BlindOracle
Integration
- Coinbase AgentKit Plugin - Action provider for AgentKit (Python)
Blog Posts
- Chaumian Blind Signatures Meet AI Prediction Markets - Technical deep-dive on privacy-preserving prediction markets
- CaMel 4-Layer Security for Multi-Agent Systems - Security architecture overview
- Guardian Federations for AI Agents - Tutorial on guardian-network integration
- Instant Micropayments for Agent-to-Agent Settlement - Sub-cent settlement implementation
- Chainlink CRE Privacy Integration - CRE workflow privacy layer
Technical Papers
- Commitment Scheme Whitepaper - SHA256(secret || position || amount) specification
- SRVL Protocol Whitepaper - Service verification and lifecycle protocol
Security
- MASSAT Assessment Results - Multi-Agent System Security Assessment (87 tests)
Pricing
Volume Tiers
| Tier | Volume | Price |
|---|---|---|
| Developer Trial | First 1,000 settlements | Free (no credit card) |
| Growth | 1,001 - 10,000 / month | Standard per-call pricing |
| Fleet | 10,000+ / month | 40% volume discount |
Per-Call Pricing (Growth tier)
| Service | Cost (USDC) |
|---|---|
| Create Forecast Market | $0.001 |
| Submit Position | $0.0005 |
| Resolve Market | $0.002 |
| Verify Identity | $0.0002 |
| Mint Badge | $0.001 |
| Check Balance | Free |
| Create Invoice | $0.0001 |
| Transfer Quote | Free |
Integration
MCP Server
BlindOracle is available as a hosted MCP server. Add to your agent's MCP configuration:
{
"mcpServers": {
"blindoracle": {
"url": "https://craigmbrown.com/api/mcp",
"description": "Privacy-first settlement and identity for autonomous agents"
}
}
}
x402 Payment Headers
X-402-Payment: <payment_proof>
X-Agent-Id: <your_agent_id>
X-Payment-Rail: private|instant|onchain (default: private)
Links
- API: https://craigmbrown.com/api
- Web: https://craigmbrown.com/api/blindoracle/
- Nostr: NIP-89 service discovery on relay.damus.io
License
Copyright (c) 2025-2026 Craig M. Brown. All rights reserved.
Documentation is provided for reference. Source code is proprietary.