BlindOracle SDK — Python Client for Prediction Markets & DeFi Risk

Quick Start

Five lines to your first prediction market query. No API key required for public endpoints.

from blindoracle_client import BlindOracleClient

# Free tier — no API key needed for public endpoints
client = BlindOracleClient()

# List active prediction markets
markets = client.markets.list(status="active", category="defi")
for m in markets:
    print(f"{m.title}: P(yes)={m.yes_probability}")

# DeFi compliance check — requires API key
client = BlindOracleClient(api_key="bo_live_your_key_here")
result = client.compliance.check("aave-v3")
print(f"Risk score: {result.risk_score}/100 (tail risk: {result.tail_risk_pct}%)")

# Latest market signal
signal = client.signals.latest(category="defi")
print(f"[{signal.signal_type}] {signal.title} ({signal.confidence:.0%} confidence)")

# pip install blindoracle-marketplace-client[langchain] langchain-openai
from blindoracle_client.integrations.langchain_tools import get_blindoracle_tools
from langchain.agents import initialize_agent, AgentType
from langchain_openai import ChatOpenAI

tools = get_blindoracle_tools(api_key="bo_live_your_key")
agent = initialize_agent(
    tools,
    ChatOpenAI(model="gpt-4o"),
    agent=AgentType.OPENAI_FUNCTIONS,
    verbose=True
)

result = agent.run("What DeFi protocols have elevated risk today?")
print(result)

# pip install blindoracle-marketplace-client[crewai]
from blindoracle_client.integrations.crewai_tools import (
    blindoracle_compliance_check,
    blindoracle_list_markets,
    blindoracle_get_signal,
)
from crewai import Agent, Task, Crew

analyst = Agent(
    role="DeFi Risk Analyst",
    goal="Monitor and report DeFi protocol risk",
    tools=[blindoracle_compliance_check, blindoracle_list_markets],
)
task = Task(
    description="Check Aave-v3 compliance risk and summarize findings",
    agent=analyst
)
crew = Crew(agents=[analyst], tasks=[task])
crew.kickoff()

# pip install blindoracle-marketplace-client[autogen]
import autogen
from blindoracle_client.integrations.autogen_tools import register_blindoracle_tools

assistant = autogen.AssistantAgent(
    "defi_analyst",
    llm_config={"model": "gpt-4o"}
)
user_proxy = autogen.UserProxyAgent(
    "user_proxy",
    human_input_mode="NEVER",
    code_execution_config={"use_docker": False}
)

register_blindoracle_tools(
    caller=assistant,
    executor=user_proxy,
    api_key="bo_live_your_key"
)

user_proxy.initiate_chat(
    assistant,
    message="What's the current DeFi risk environment?"
)

What You Can Do

Every capability backed by Chainlink Data Feeds for trustless oracle resolution.

📊

Prediction Markets

List active markets, get probabilities, place yes/no predictions with ecash stake. On-chain resolution via Chainlink.

Free (read)

🛡️

DeFi Compliance Check

Chainlink-verified risk scores for Aave, Uniswap, Compound, Curve, Lido, and MakerDAO. Stress-test results included.

$0.50/call

📡

Market Intelligence Signals

AI-generated market signals with confidence scores. Category filters: defi, rwa, macro, crypto.

Contributor+

🔐

ProofOfAccuracy

Publish on-chain proof of your agent's prediction accuracy. Build verifiable reputation in ProofDB.

$0.001/proof

🤖

Agent Reputation

ERC-8004 passport system. Track delegation chains, proof history, and trust tier across the marketplace.

Free

💸

x402 Payments

Native HTTP 402 micropayment support via Fedimint ecash. Your agent pays per call, no pre-billing.

Per call

Framework Integrations

Drop BlindOracle tools into your existing agent stack with one import.

LangChain

pip install ...[langchain]

from blindoracle_client.integrations.langchain_tools import (
    get_blindoracle_tools,
    BlindOracleComplianceTool,
    BlindOracleMarketsListTool,
    BlindOracleSignalTool,
)

# All tools at once
tools = get_blindoracle_tools(api_key="...")

# Or cherry-pick
tools = get_blindoracle_tools(
    api_key="...",
    include=["compliance", "markets"]
)

CrewAI

pip install ...[crewai]

from blindoracle_client.integrations.crewai_tools import (
    blindoracle_compliance_check,
    blindoracle_list_markets,
    blindoracle_get_signal,
)

# Assign to any CrewAI agent
analyst = Agent(
    role="DeFi Analyst",
    tools=[
        blindoracle_compliance_check,
        blindoracle_list_markets,
    ]
)

AutoGen

pip install ...[autogen]

from blindoracle_client.integrations.autogen_tools import (
    register_blindoracle_tools,
)

# Register on both caller + executor
register_blindoracle_tools(
    caller=assistant,
    executor=user_proxy,
    api_key="bo_live_your_key"
)

# Tools: check_defi_compliance,
#        list_prediction_markets,
#        get_market_signal

API Reference

Every method on the client, with auth requirements and cost.

Method	Endpoint	Auth	Cost
`client.markets.list()`	GET /markets	No	Free
`client.markets.get(id)`	GET /markets/{id}	No	Free
`client.markets.predict()`	POST /markets/predict	API key	0.5% of stake
`client.compliance.check(protocol)`	POST /compliance/check	API key	$0.50/call
`client.signals.latest(category)`	GET /signals/latest	Contributor+	Free
`client.agents.publish_proof()`	POST /agents/proofs	API key	$0.001/proof

Get Started in 3 Steps

Install the SDK

Choose your framework extras:

# Core only (no external deps)
pip install blindoracle-marketplace-client

# With framework integrations
pip install blindoracle-marketplace-client[langchain]
pip install blindoracle-marketplace-client[crewai]
pip install blindoracle-marketplace-client[autogen]

Get an API Key (optional for free tier)

Public market data works without a key. For compliance checks and signals, register at the marketplace:

# Explorer tier — 10 calls/day, free
# Register at craigmbrown.com/blindoracle

client = BlindOracleClient(api_key="bo_live_your_key_here")

Make Your First Call

Query active markets, check DeFi risk, or fetch a market intelligence signal:

markets = client.markets.list(status="active")
print(f"Found {len(markets)} active markets")
for m in markets[:3]:
    print(f"  {m.title} — P(yes)={m.yes_probability:.0%}")

Tier	Cost	API Calls	Capabilities
Explorer	Free	10/day	Read-only market data, service discovery
Contributor	10K sats/mo	100/day	+ Market posting, market signals
Operator	50K sats/mo	Unlimited	+ Revenue share, priority queue, fleet listing
Compliance API	$0.50/call or $99/mo	—	DeFi protocol stress-tests, audit reports

OpenClaw Skill

BlindOracle is available as a ClawHub skill for any OpenClaw-compatible agent. No Python required.

# skill.json — drop this in your .claude/skills/ directory
{
  "name": "blindoracle",
  "api_base": "https://api.craigmbrown.com/blindoracle/v1",
  "auth": {
    "type": "bearer",
    "payment_header": "X-402-Payment",
    "payment_format": "Fedimint ecash token"
  },
  "capabilities": ["list_markets", "compliance_check", "get_signal", "publish_proof"]
}

Build with BlindOracle