# DYOR Knowledge Graph Semantic Search

> DYOR Knowledge Graph Semantic Search is a paid API for AI agents from kg.dyor.network, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-09).

Semantic search over 586K+ crypto entities (tokens, protocols, chains, investors, people) combining exact name matching with vector similarity for fuzzy discovery

## Facts

- Endpoint: GET https://kg.dyor.network/api/search?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-09
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kg-dyor-network-c0e1afd8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ul04fwibtpq-64OqntYkI

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability kg-dyor-network-c0e1afd8
```

Example prompt: Search the DYOR crypto knowledge graph for 'layer 2 scaling solutions' and return the top 5 matching entities with their URIs and similarity scores.

## When to prefer this

Use this endpoint when you need to discover or identify crypto entities (tokens, protocols, chains, investors, people) by name or concept, especially when the exact name is unknown or fuzzy. Ideal as a first step before calling relationship, SPARQL, or risk-analysis endpoints that require a canonical entity URI. Prefer over SPARQL when doing open-ended discovery rather than structured graph queries.

## Known failure modes

- Query parameter missing — returns 400 error
- No matching entities found — returns empty results array with total_count 0
- Query too vague or nonsensical — returns low-similarity results or empty set
- Rate limit or payment failure via x402 — returns 402 payment required
- Service unavailable — returns 5xx error

## How this service works

Semantic search over 586K+ crypto entities — find tokens, protocols, chains, investors, and people by name or meaning. Combines exact name matching with vector similarity for fuzzy discovery. Returns URIs, labels, and similarity scores | ZWING Intelligence (https://zwing.bot) — contact: v@zwing.bot, Telegram: @valery_zzz

## Output

Returns a JSON object with the original query, status, total_count of matches, and an array of results each containing: uri (canonical knowledge graph URI), name (entity label), labels (array of category tags), similarity score (0-1, where 1 is exact match), and a description snippet of the entity.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "limit": 10,
   "query": "ethereum"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "default": 10
      },
      "query": {
       "type": "string",
       "description": "Entity name or semantic search query"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "query": {
       "type": "string"
      },
      "status": {
       "type": "string"
      },
      "results": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "uri": {
          "type": "string"
         },
         "name": {
          "type": "string"
         },
         "labels": {
          "type": "array",
          "items": {
           "type": "string"
          }
         },
         "similarity": {
          "type": "number"
         }
        }
       }
      },
      "total_count": {
       "type": "integer"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kg-dyor-network-c0e1afd8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kg.dyor.network](https://www.zero.xyz/host/kg.dyor.network/llms.txt)