# Yodeler News API

Yodeler exposes paid Telegram and Discord news data through x402 for AI agents, bots, and data pipelines.

## Start here
- OpenAPI: https://x402.yodeler.xyz/openapi.json
- Agent manifest: https://x402.yodeler.xyz/.well-known/agent.json
- x402 discovery: https://x402.yodeler.xyz/.well-known/x402.json
- Discovery index: https://x402.yodeler.xyz/v1/discovery
- Free availability preview: https://x402.yodeler.xyz/v1/news/availability
- Free channel catalog: https://x402.yodeler.xyz/v1/news/channels
- Pricing card: https://x402.yodeler.xyz/v1/news/pricing
- Aggregate spend summary: https://x402.yodeler.xyz/v1/news/spend
- Intelligence market catalog: https://x402.yodeler.xyz/v1/intelligence/markets
- Intelligence source catalog: https://x402.yodeler.xyz/v1/intelligence/sources
- Intelligence market stats: https://x402.yodeler.xyz/v1/intelligence/stats
- Free sandbox batch (synthetic data): https://x402.yodeler.xyz/v1/news/sandbox
- Machine-readable data license: https://x402.yodeler.xyz/v1/license
- x402 health: https://x402.yodeler.xyz/health/x402
- Terms: https://x402.yodeler.xyz/terms
- Privacy: https://x402.yodeler.xyz/privacy
- Data provenance: https://x402.yodeler.xyz/data-provenance
- Support: https://x402.yodeler.xyz/support
- Paid endpoint: https://x402.yodeler.xyz/v1/news

## Payment
- Protocol: x402
- Scheme: exact
- Network: eip155:8453 (Base)
- Asset: USDC
- Empty results are free.

## Recommended agent flow
1. Read /.well-known/x402.json, /.well-known/agent.json, or /v1/discovery.
2. Call /v1/news/channels to discover source IDs.
3. Call /v1/news/availability with channel, since, and limit.
4. If rows are available, request /v1/news without payment to receive HTTP 402 requirements.
5. Pay with an x402-compatible client and retry with X-Payment.