cryptofeed402

Free: latest brief teaser text, Hyperliquid extreme funding (8h-equivalent rates), BTC/ETH/SOL prices with 24h change.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Free: a delayed, trimmed sample of the twice-daily crypto brief (previous edition; no OI, sentiment or markdown). Use to evaluate before paying for get_latest_brief.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Free: current per-call prices (USDC on Base via x402), network and payTo address.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Free: ask cryptofeed402 to consider monitoring a coin it does not cover yet (covered: BTC, ETH, SOL, HYPE, NEAR, AAVE). Logged for human review; high-demand assets may be added to the brief and paid endpoints later. Not a guarantee. Limit 10/hour/IP; repeat asks for the same symbol within 24h count once.

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Ticker, e.g. LINK (2-15 chars, letters/digits, optional hyphen; leading $ ok)",
      "minLength": 2,
      "maxLength": 16
    },
    "reason": {
      "type": "string",
      "description": "Optional short reason (<=200 chars)",
      "maxLength": 200
    },
    "agent": {
      "type": "string",
      "description": "Optional agent name/id (<=80 chars)",
      "maxLength": 80
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false
}

Free: tell cryptofeed402 how often you want briefs/reports and the best UTC hours to have a fresh one ready, so we can schedule to match. Logged as aggregate demand (GET /feedback/schedule shows counts only; notes and agent names are never published; no IPs stored). Limit 10/hour/IP.

{
  "type": "object",
  "properties": {
    "frequency": {
      "type": "string",
      "enum": [
        "hourly",
        "every_4h",
        "every_6h",
        "every_12h",
        "daily",
        "on_event"
      ]
    },
    "preferred_utc_hours": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 23
      },
      "maxItems": 6,
      "uniqueItems": true,
      "description": "Up to 6 UTC hours (0-23); [] = no preference"
    },
    "symbols": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Z0-9]{1,20}$"
      },
      "maxItems": 20,
      "uniqueItems": true
    },
    "routes_of_interest": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "/price/{symbol}",
          "/funding/extreme",
          "/brief/latest",
          "/history",
          "/perps/{symbol}",
          "/sentiment/{symbol}",
          "/audit/agent-ready",
          "/brief/teaser",
          "/brief/sample"
        ]
      },
      "uniqueItems": true
    },
    "agent_name": {
      "type": "string",
      "maxLength": 64
    },
    "note": {
      "type": "string",
      "maxLength": 280,
      "description": "Plain text"
    }
  },
  "required": [
    "frequency",
    "preferred_utc_hours"
  ],
  "additionalProperties": false
}

Free: top 20 coins other agents have asked cryptofeed402 to monitor in the last 30 days (aggregate counts only).

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Paid endpoint: perp mark, funding, OI (Hyperliquid) plus OKX spot for one coin. Returns the x402 payment requirements and URL; pay with your own x402 client.

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "enum": [
        "BTC",
        "ETH",
        "SOL",
        "HYPE",
        "NEAR",
        "AAVE"
      ]
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false
}

Paid endpoint: most extreme Hyperliquid funding rates right now. Returns the x402 payment requirements and URL.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Paid endpoint: the full latest twice-daily crypto research brief (JSON + markdown). Returns the x402 payment requirements and URL.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Free: a cached example agent-readiness audit of cryptofeed402.site (score 0-100, pass/warn/fail per check with evidence and fixes) so you can see the output of audit_agent_ready before paying.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Paid endpoint ($0.002): one Hyperliquid perp's funding (hourly, 8h, annualized), open interest in USD, 24h volume, mark/oracle price, premium and whether it is in the top-10 funding extremes. Any listed Hyperliquid perp; unknown symbols return an error and no charge. Returns the x402 payment requirements and URL.

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,20}$",
      "description": "Hyperliquid perp ticker, e.g. BTC, ETH, SOL, HYPE"
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false
}

Paid endpoint ($0.002): crypto news sentiment for one asset: -1..1 score, bearish/neutral/bullish label, pos/neg/neu headline counts and up to 5 top headlines with links. Headlines labeled by a local LLM, score is plain math, refreshed about every 15 min. Symbols not in the current snapshot or stale data return an error and no charge (free list: GET /sentiment). Returns the x402 payment requirements and URL.

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,20}$",
      "description": "Ticker, e.g. BTC, ETH, SOL"
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false
}

Paid endpoint ($0.05): audits a public website or x402 API for AI-agent readiness (llms.txt, robots.txt AI rules, sitemap, OpenAPI, /.well-known/x402, agent card, MCP initialize, a live unpaid 402 challenge, Bazaar metadata, Roundhouse / 402 Index / x402 Doctor listings). Deterministic, no LLM. Returns the x402 payment requirements and URL; see get_audit_sample for the output format.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Domain or http(s) URL of the site to audit (public hosts, ports 80/443)",
      "maxLength": 2048
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

Paid endpoint: archived briefs for a date range. Returns the x402 payment requirements and URL.

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "required": [
    "from"
  ],
  "additionalProperties": false
}