DYOR Knowledge Graph

Crypto-native knowledge graph API with 586K+ entities and 28 AI-generated signal types. All endpoints pay per request via x402 (USDC on Base) — no API key, no registration.

OpenAPI spec · Signal catalog (visual) · agentic.market listing · Full ontology (JSON)

How it works

1. Send a request to any paid endpoint — you get back HTTP 402 with a payment-required header
2. Your x402 client signs a USDC payment on Base and retries with a payment-signature header
3. The server verifies and settles the payment, then returns the data

Free endpoints

GET /api/schema free

Full ontology: all RDF predicates, OWL classes, and time-series table schemas. Use this to write SPARQL queries and understand the data model.

GET /api/signals/catalog free

All 28 signal type definitions with descriptions, scoring criteria, and evidence schemas. Also browsable at zwing.bot/signals.

GET /api/insights/signals free

Recent signals overview across all types. Good for seeing what's active before drilling into specific types.

Paid endpoints

POST /api/sparql $0.05

Query the RDF knowledge graph with SPARQL. Covers 8,200+ protocols, tokens, chains, investors, governance, and DeFi data from DefiLlama, CryptoRank, CoinGecko, TokenTerminal, Snapshot, and Tally.

{
  "query": "PREFIX dk: <https://schema.dyor.bot/crypto-kg#>
SELECT ?token ?name WHERE {
  ?token a dk:Token ;
         <http://schema.org/name> ?name .
} LIMIT 10"
}

POST /api/search $0.05

Semantic search over 586K+ entities. Combines exact name matching with vector similarity.

{
  "query": "Ethereum L2 scaling",
  "limit": 10,
  "entity_types": ["Protocol", "Chain"]
}

POST /api/explore $0.05

Explore an entity's relationships: investors, team, ecosystem, DeFi pools, GitHub repos, governance, and financial metrics.

{
  "entity_name": "Aave",
  "focus": ["investment", "team", "defi"]
}

POST /api/timeseries $0.05

Historical time-series data via SQL: token prices, market caps, TVL, protocol revenue, DeFi pool APY, lending rates, stablecoin supply. Updated daily from CoinGecko, DefiLlama, TokenTerminal, CryptoRank.

{
  "sql_query": "SELECT entity_id, \"currentPrice\", \"marketCap\"
FROM ts_coingecko_token
WHERE date = CURRENT_DATE
ORDER BY \"marketCap\" DESC LIMIT 10"
}

GET /api/changes $0.05

Real-time changes to the knowledge graph: new tokens, updated metrics, new investor relationships, governance proposals.

GET /api/insights/signals/{signal_type} $0.10

Signals by type with full evidence chains. 28 types covering insider accumulation, whale activity, sector rotation, yield anomalies, utilization stress, governance risk, token unlock pressure, and cross-domain convergence. See catalog for all types.

GET /api/insights/entity/{entity_name} $1.00

Comprehensive risk and opportunity analysis for any entity. Returns all active signals across 28 types plus AI-synthesized narratives with actionability ratings.

POST /api/insights/batch $5.00

Portfolio-level risk analysis for up to 10 entities in one call. Same depth as entity insights, aggregated.

{
  "entities": ["Aave", "Uniswap", "Ethereum"],
  "since_hours": 168
}

MCP (Model Context Protocol)

Connect any MCP-compatible AI agent to the knowledge graph:

https://kg.dyor.network/mcp

Same tools and pricing as the REST API, accessed via MCP tool calls.

Data sources