--- name: kg.dyor.network description: kg.dyor.network provides access to the DYOR crypto knowledge graph, a structured database of 586K+ crypto entities including tokens, protocols, chains, organizations, people, and exchanges. It exposes two capabilities: semantic search over those entities and a paginated feed of recent changes to the graph. It does not provide real-time price data, on-chain transaction data, or streaming event subscriptions. host: kg.dyor.network --- # kg.dyor.network DYOR Network is a crypto-domain knowledge graph host serving agents that need to resolve entity identifiers, discover new or updated entities, and track structural changes to the crypto ecosystem over time. It is distinct from market data APIs (no prices, no OHLCV) and blockchain RPCs (no wallet balances, no raw transactions). Its value is stable, semantically searchable entity records and a changelog feed for those records. ## When to use this host Use kg.dyor.network when an agent needs to resolve crypto entity names to stable identifiers, discover entities by semantic similarity, or track structural changes to the crypto knowledge graph over a recent time window. Do not use it for real-time or historical price data — use a market data API (e.g. CoinGecko, CoinMarketCap, or an exchange API) instead. Do not use it for on-chain data such as wallet balances, transaction histories, or contract state — use a blockchain RPC or indexer instead. Do not use it for streaming event subscriptions; the change feed is a single-shot paginated query only. This host is best suited as a resolution and discovery layer that feeds entity URIs into other, more specialized data sources. ## Capabilities ### Entity Discovery and Resolution Allows agents to find and resolve crypto entities by name or semantic meaning, returning stable URIs and relevance scores usable as identifiers in downstream calls. - **`search-dyor-knowledge-graph`** — Performs semantic search over 586K+ crypto entities in the DYOR knowledge graph, returning ranked matches with URIs, names, and similarity scores. ### Knowledge Graph Change Tracking Provides a paginated, filterable feed of recent CREATE and UPDATE operations on graph entities, enabling agents to detect newly listed tokens, updated protocol metrics, recorded insider transactions, or new governance proposals within a configurable time window. - **`fetch-knowledge-graph-changes`** — Returns a paginated feed of recent crypto knowledge graph changes, including entity URI, type, operation (CREATE/UPDATE), and timestamp, optionally filtered by entity or operation type. ## Workflows ### Discover and Monitor New Entities *Use when an agent needs to identify which recently added or updated entities in the knowledge graph match a concept of interest, such as finding all newly listed tokens on a specific chain.* 1. **`fetch-knowledge-graph-changes`** — Retrieve recent CREATE or UPDATE operations from the knowledge graph feed, filtered by entity type or operation as needed, to obtain a list of recently changed entity URIs and names. 2. **`search-dyor-knowledge-graph`** — Run a semantic search using names or concepts derived from the change feed results to confirm entity identity, retrieve stable URIs, and rank relevance for downstream processing. ## Skill reference ### `fetch-knowledge-graph-changes` **DYOR Network Knowledge Graph Changes Feed** — Returns a paginated feed of recent crypto knowledge graph changes, including entity URI, type, operation (CREATE/UPDATE), and timestamp, optionally filtered by entity or operation type. *Use when:* Use when an agent needs to track recent additions or updates to the DYOR crypto knowledge graph, such as new tokens listed, insider transactions recorded, protocol metrics updated, or governance proposals created within a configurable time window. *Not for:* Do not use for streaming real-time event subscriptions; this is a single-shot paginated query. Do not use to retrieve full entity details — use an entity lookup endpoint instead. **Inputs:** - `since_hours` (number) — Look-back window in hours. Defaults to 72. - `limit` (integer) — Maximum number of change records to return. Defaults to 100. - `entity_uri` (string) — Filter changes to a specific entity by its URI. - `operation` (string) — Filter by operation type. Allowed values: CREATE, UPDATE. - `summary` (boolean) — When true, returns aggregate counts instead of individual change records. Defaults to false. **Returns:** Returns a changes array where each item contains entity_uri, name, type (e.g. InsiderTransaction), ISO 8601 timestamp, and operation (CREATE or UPDATE). **Example:** `GET https://kg.dyor.network/api/changes?since_hours=24&limit=50&operation=CREATE` --- ### `search-dyor-knowledge-graph` **DYOR Knowledge Graph Search** — Performs semantic search over 586K+ crypto entities in the DYOR knowledge graph, returning ranked matches with URIs, names, and similarity scores. *Use when:* Use when an agent needs to look up or resolve crypto entities — tokens, protocols, chains, organizations, people, or exchanges — by name or semantic meaning, and requires stable identifiers and relevance scores. *Not for:* Do not use for real-time price data, on-chain transaction lookups, or wallet balance queries; use a market data or blockchain RPC API instead. **Inputs:** - `query` (string, required) — Entity name or semantic search query to match against the knowledge graph. - `limit` (integer) — Maximum number of results to return. Defaults to 10. - `entity_types` (array) — Filter results by entity type. Allowed values: Token, Protocol, Chain, Organization, Person, Exchange, Pool. **Returns:** Returns status='success', the echoed query, a total_count, and a results array of up to 10 entities each with a stable URI, name, labels array, similarity score (0–1), and optional description. **Example:** `{"query": "solana", "limit": 10}` ---