# DYOR Network Entity Insights API

> DYOR Network Entity Insights API is a paid API for AI agents from api.dyor.network, paid per call via x402, $1.5/call, status unknown (last checked 2026-09-14).

Returns comprehensive risk and opportunity signals with AI-synthesized narratives for a named crypto entity, covering smart money flows, DeFi risk, governance, token unlocks, and more.

## Facts

- Endpoint: GET https://api.dyor.network/api/insights/entity/Ethereum
- Price: $1.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/dyor-network-entity-insights-api-bd9d7bf8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eh0Yznltmp5d_kvXKFRzt

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 dyor-network-entity-insights-api-bd9d7bf8
```

Example prompt: Pull up all active risk and opportunity signals for Ethereum from the last 7 days — I want to see smart money flows, governance alerts, token unlock risks, and the AI-written narratives with actionability ratings.

## When to prefer this

Use this endpoint when you need a deep, multi-dimensional intelligence report on a single named crypto entity — spanning on-chain risk, governance, yield anomalies, and smart money signals — with AI-written narratives and actionability ratings. Prefer this over the portfolio endpoint when focusing on one entity and needing full evidence detail. Prefer over generic search endpoints when you already know the entity name and want all signal types at once.

## Known failure modes

- Unknown or misspelled entity name returns empty signals array — use GET /api/search to validate entity names first
- 402 Payment Required if x402 payment header is missing or payment fails
- Invalid since_hours value may return default 168-hour window without error
- Rate limiting or quota exhaustion returns 429 error
- Entity exists but has no signals in the requested time window returns signal_count: 0

## How this service works

Comprehensive risk and opportunity analysis for any crypto entity. Returns all active signals with full evidence across 28 signal types: smart money flows, DeFi risk, governance, token unlocks, yield anomalies, and cross-domain convergence alerts. Includes AI-synthesized narratives with actionability ratings. Free signal browsing at GET /api/insights/signals, full catalog at GET /api/signals/catalog | ZWING Intelligence (https://zwing.finance) — contact: v@zwing.finance, Telegram: @valery_zzz

## Output

Returns a list of active signals (each with signal_id, signal_type, score, qualification, evidence, entities, and timestamps) plus AI-synthesized narrative objects (headline, body, actionability rating, score) and aggregate counts — covering up to 28 signal types for the queried crypto entity over the specified time window.

## 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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "entity_name"
     ],
     "properties": {
      "entity_name": {
       "type": "string",
       "description": "Crypto entity name in the URL path — e.g. Aave, Ethereum, Uniswap (use GET /api/search for exact names)"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "since_hours": {
       "type": "number",
       "default": 168,
       "description": "Look back window in hours (default 7 days)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "signals": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "score": {
          "type": "number"
         },
         "entities": {
          "type": "array",
          "items": {
           "type": "string"
          }
         },
         "evidence": {
          "type": "object"
         },
         "metadata": {
          "type": "object"
         },
         "signal_id": {
          "type": "string"
         },
         "created_at": {
          "type": "string"
         },
         "signal_type": {
          "type": "string"
         },
         "qualification": {
          "type": "string"
         }
        }
       }
      },
      "narratives": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "body": {
          "type": "string"
         },
         "score": {
          "type": "number"
         },
         "entity": {
          "type": "string"
         },
         "headline": {
          "type": "string"
         },
         "signal_type": {
          "type": "string"
         },
         "actionability": {
          "type": "string"
         }
        }
       }
      },
      "signal_count": {
       "type": "integer"
      },
      "narrative_count": {
       "type": "integer"
   
… (truncated)
```

## More

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