{"schema_version":"1.0","service":{"name":"Yodeler News API","description":"Agent-ready x402 access to forwarded Telegram and Discord news rows with availability-aware pricing, free previews, a free channel catalog, and clean JSON responses.","documentation_url":"/docs","openapi_url":"/openapi.json","health_url":"/health","agent_manifest_url":"/.well-known/agent.json","discovery_index_url":"/v1/discovery","absolute_urls":{"docs":"https://x402.yodeler.xyz/docs","overview":"https://x402.yodeler.xyz/about","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","availability_preview":"https://x402.yodeler.xyz/v1/news/availability","quote_preview":"https://x402.yodeler.xyz/v1/news/quote","channel_catalog":"https://x402.yodeler.xyz/v1/news/channels","pricing":"https://x402.yodeler.xyz/v1/news/pricing","spend_summary":"https://x402.yodeler.xyz/v1/news/spend","intelligence_markets":"https://x402.yodeler.xyz/v1/intelligence/markets","intelligence_sources":"https://x402.yodeler.xyz/v1/intelligence/sources","intelligence_stats":"https://x402.yodeler.xyz/v1/intelligence/stats","x402_health":"https://x402.yodeler.xyz/health/x402","paid_news":"https://x402.yodeler.xyz/v1/news","funnel_metrics":"https://x402.yodeler.xyz/v1/news/funnel","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","llms":"https://x402.yodeler.xyz/llms.txt","robots":"https://x402.yodeler.xyz/robots.txt","sitemap":"https://x402.yodeler.xyz/sitemap.xml","sandbox_news":"https://x402.yodeler.xyz/v1/news/sandbox","data_license":"https://x402.yodeler.xyz/v1/license","health":"https://x402.yodeler.xyz/health"},"keywords":["x402","402 Payment Required","paid API","micropayments","USDC","Base","Base mainnet","Base Sepolia","AI agents","agent tools","Telegram news","Discord news","news data API","pay-per-request","machine-readable pricing","real-time intelligence","agent intelligence market"]},"x402":{"protected_resource":{"method":"GET","path":"/v1/news","description":"Buy a batch of forwarded news rows with free empty-result fallback."},"quote_resource":{"method":"GET","path":"/v1/news/quote","description":"Preview an availability-aware quote for the same query without payment."},"availability_resource":{"method":"GET","path":"/v1/news/availability","description":"Preview result availability and whether the query will be free."},"configured_network":{"id":"eip155:8453","label":"Base","configured":true},"supported_networks":[{"id":"eip155:8453","label":"Base","configured":true},{"id":"eip155:84532","label":"Base Sepolia","configured":false}],"facilitator_url":"https://api.cdp.coinbase.com/platform/v2/x402","scheme":"exact","asset":"USDC","pricing":{"currency":"USD","currencySymbol":"$","asset":"USDC","assetAddress":"0x833589fCD6EDb6E08f4c7C32D4f71b54bdA02913","network":"eip155:8453","networkLabel":"Base","scheme":"exact","basePrice":"$0.01","model":"availability-aware-count-and-freshness","dimensions":["billable_count","freshness"],"billingStrategy":"exact-from-availability","previewPath":"/v1/news/quote","availabilityPreviewPath":"/v1/news/availability","protectedPath":"/v1/news","freeOnEmptyResults":true,"limitTiers":[{"upTo":50,"multiplier":"1x"},{"upTo":200,"multiplier":"2x"},{"upTo":500,"multiplier":"4x"}],"freshnessTiers":[{"lookbackHours":6,"multiplier":"1.25x","tier":"recent_6h"},{"lookbackHours":24,"multiplier":"1.1x","tier":"recent_24h"}],"freshnessDefinitions":[{"tier":"recent_6h","maxLookbackHours":6,"rule":"`since` is within the last 6 hours."},{"tier":"recent_24h","maxLookbackHours":24,"rule":"`since` is older than 6 hours and within the last 24 hours."},{"tier":"older","maxLookbackHours":null,"rule":"`since` is older than 24 hours, or no `since` filter was provided."}],"defaultLimit":50,"maxLimit":500,"suggestedTestingPriceRange":"$0-$0.05","facilitatorUrl":"https://api.cdp.coinbase.com/platform/v2/x402","sellerWalletConfigured":true,"quoteTtlSeconds":300,"paymentTimeoutSeconds":300,"freshnessSlaSeconds":300,"license":{"id":"yodeler-data-license-1.0","name":"Yodeler Data License","url":"https://x402.yodeler.xyz/terms","redistribution":false,"aiTrainingAllowed":true,"attributionRequired":true,"termsUrl":"https://x402.yodeler.xyz/terms","provenanceUrl":"https://x402.yodeler.xyz/data-provenance"},"sandboxPath":"/v1/news/sandbox","licensePath":"/v1/license","supportsCursorPagination":true,"supportsConditionalRequests":true,"supportsBudgetHeader":"X-Max-Price","sort":"created_at_desc","representativeQuotes":[{"label":"Empty query","query":{"limit":50,"channel":999999},"quote":{"price":"$0","currency":"USD","network":"eip155:8453","pay_to":"0x0093406A8805ADf3b397c28366402AAD9163Afda","pricing_model":"availability-aware-count-and-freshness","pricing_dimensions":["billable_count","freshness"],"quote_id":"news_fa86774722ca7b39","quote_expires_at":"2026-07-07T04:02:22.724695Z","pricing_hash":"fa86774722ca7b39e7dce1fddf7f5f298edc1a8ebf36ddcbd3c3088e396259a1","limit":50,"channel":999999,"since":null,"valid_until":"2026-07-07T04:02:22.724861Z","license":"yodeler-data-license-1.0","availability":{"available_count":0,"billable_count":0,"is_free":true},"breakdown":{"base_price":"$0.01","final_price":"$0","count_multiplier":"0x","freshness_multiplier":"1x","freshness_tier":"older","billing_strategy":"exact-from-availability"}}},{"label":"Medium older batch","query":{"limit":200},"quote":{"price":"$0.02","currency":"USD","network":"eip155:8453","pay_to":"0x0093406A8805ADf3b397c28366402AAD9163Afda","pricing_model":"availability-aware-count-and-freshness","pricing_dimensions":["billable_count","freshness"],"quote_id":"news_8fe74c427792f122","quote_expires_at":"2026-07-07T04:02:22.724946Z","pricing_hash":"8fe74c427792f12240f11a5b08717ad50357ddc4f808f150c5152b5f93d95fd1","limit":200,"channel":null,"since":null,"valid_until":"2026-07-07T04:02:22.725046Z","license":"yodeler-data-license-1.0","availability":{"available_count":180,"billable_count":180,"is_free":false},"breakdown":{"base_price":"$0.01","final_price":"$0.02","count_multiplier":"2x","freshness_multiplier":"1x","freshness_tier":"older","billing_strategy":"exact-from-availability"}}},{"label":"Large breaking batch","query":{"limit":500,"since":"2026-07-07T01:57:22.725082Z"},"quote":{"price":"$0.05","currency":"USD","network":"eip155:8453","pay_to":"0x0093406A8805ADf3b397c28366402AAD9163Afda","pricing_model":"availability-aware-count-and-freshness","pricing_dimensions":["billable_count","freshness"],"quote_id":"news_a778531ed999e84d","quote_expires_at":"2026-07-07T04:02:22.725187Z","pricing_hash":"a778531ed999e84d950ea084a4384571c9bd9ec8282be8a256599fdce5bee53c","limit":500,"channel":null,"since":"2026-07-07T01:57:22.725113Z","valid_until":"2026-07-07T04:02:22.725286Z","license":"yodeler-data-license-1.0","availability":{"available_count":500,"billable_count":500,"is_free":false},"breakdown":{"base_price":"$0.01","final_price":"$0.05","count_multiplier":"4x","freshness_multiplier":"1.25x","freshness_tier":"recent_6h","billing_strategy":"exact-from-availability"}}}]},"payment_flow":[{"step":1,"action":"Preview availability or request the protected resource.","endpoint":"/v1/news/availability"},{"step":2,"action":"Request GET /v1/news without payment to receive a clean 402 challenge if rows are available.","endpoint":"/v1/news"},{"step":3,"action":"Decode the payment requirements from the payment-required header.","header":"payment-required"},{"step":4,"action":"Submit payment through your x402-compatible client and retry the same request.","header":"X-Payment"}],"distribution":{"categories":["data","news","telegram","discord","x402","agent-tools"],"keywords":["x402","402 Payment Required","paid API","micropayments","USDC","Base","Base mainnet","Base Sepolia","AI agents","agent tools","Telegram news","Discord news","news data API","pay-per-request","machine-readable pricing","real-time intelligence","agent intelligence market"],"marketplaces":[{"name":"x402 Bazaar","status":"ready","extension":"bazaar"},{"name":"OpenAPI tool registries","status":"ready","path":"/openapi.json"},{"name":"Agent manifest directories","status":"ready","path":"/.well-known/agent.json"}]},"well_known_x402_url":"/.well-known/x402.json","facilitator_support_note":"Base mainnet is the production target. Verify that the configured facilitator supports exact payments on eip155:8453 before launch; the public x402 facilitator may advertise EVM exact support primarily on Base Sepolia for local demos."},"json_ld":{"@context":"https://schema.org","@type":"WebAPI","name":"Yodeler News API","description":"Agent-ready x402 paid Telegram and Discord news data with free availability previews.","applicationCategory":"Data API","keywords":["x402","402 Payment Required","paid API","micropayments","USDC","Base","Base mainnet","Base Sepolia","AI agents","agent tools","Telegram news","Discord news","news data API","pay-per-request","machine-readable pricing","real-time intelligence","agent intelligence market"],"documentation":"https://x402.yodeler.xyz/docs","url":"https://x402.yodeler.xyz/v1/discovery","mainEntityOfPage":"https://x402.yodeler.xyz/about","termsOfService":"https://x402.yodeler.xyz/.well-known/x402.json","license":"https://x402.yodeler.xyz/v1/license","provider":{"@type":"Organization","name":"Wavecode Labs","url":"https://x402.yodeler.xyz"},"isAccessibleForFree":false,"offers":{"@type":"Offer","priceCurrency":"USD","availability":"https://schema.org/InStock","url":"https://x402.yodeler.xyz/v1/news/pricing"},"potentialAction":{"@type":"SearchAction","target":"https://x402.yodeler.xyz/v1/news/availability?channel={channel}&limit={limit}","query-input":["required name=channel","optional name=limit"]}},"tools":[{"name":"yodeler.get_paid_news","title":"Buy paid news rows","description":"Fetch a paid batch of forwarded Telegram and Discord news rows. Call the availability endpoint first if you want to know whether the request is free.","annotations":{"readOnlyHint":true,"idempotentHint":true},"input_schema":{"type":"object","properties":{"channel":{"type":"integer","description":"Optional Telegram source channel id filter."},"since":{"type":"string","format":"date-time","description":"Optional lower-bound timestamp for freshness-aware pricing."},"limit":{"type":"integer","minimum":1,"maximum":500,"default":50,"description":"Maximum batch size to price and return."}},"additionalProperties":false},"output_schema":{"type":"object","properties":{"count":{"type":"integer"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"source_id":{"type":"integer"},"destination_type":{"type":"string"},"destination_id":{"type":"integer"},"message_text":{"type":"string"},"created_at":{"type":"string","format":"date-time"}},"required":["id","source_id","destination_type","destination_id","message_text"],"additionalProperties":false}},"meta":{"type":"object","properties":{"channel":{"type":"integer"},"since":{"type":"string","format":"date-time"},"limit":{"type":"integer"},"available_count":{"type":"integer"},"billable_count":{"type":"integer"},"is_free":{"type":"boolean"},"delivery_mode":{"type":"string"}},"required":["limit","available_count","billable_count","is_free","delivery_mode"],"additionalProperties":false},"window":{"type":"object","properties":{"newest_created_at":{"type":"string","format":"date-time"},"oldest_created_at":{"type":"string","format":"date-time"}},"additionalProperties":false},"payment":{"type":"object","properties":{"scheme":{"type":"string"},"network":{"type":"string"},"currency":{"type":"string"},"pay_to":{"type":"string"},"asset":{"type":"string"},"amount":{"type":"string"},"price":{"type":"string"}},"required":["scheme","network","currency","pay_to","asset","amount","price"],"additionalProperties":false}},"required":["count","items","meta","window"],"additionalProperties":false},"payment":{"type":"x402","quote_path":"/v1/news/availability","required_header":"payment-required","retry_header":"X-Payment"}},{"name":"yodeler.preview_news_quote","title":"Preview x402 quote","description":"Preview the availability-aware x402 price for a news query without payment.","annotations":{"readOnlyHint":true,"idempotentHint":true},"input_schema":{"type":"object","properties":{"channel":{"type":"integer","description":"Optional Telegram source channel id filter."},"since":{"type":"string","format":"date-time","description":"Optional lower-bound timestamp for freshness-aware pricing."},"limit":{"type":"integer","minimum":1,"maximum":500,"default":50,"description":"Maximum batch size to price and return."}},"additionalProperties":false},"output_schema":{"type":"object","properties":{"price":{"type":"string"},"currency":{"type":"string"},"network":{"type":"string"},"pay_to":{"type":"string"},"pricing_model":{"type":"string"},"pricing_dimensions":{"type":"array","items":{"type":"string"}},"limit":{"type":"integer"},"channel":{"type":"integer"},"since":{"type":"string","format":"date-time"},"availability":{"type":"object","properties":{"available_count":{"type":"integer"},"billable_count":{"type":"integer"},"is_free":{"type":"boolean"}},"required":["available_count","billable_count","is_free"],"additionalProperties":false},"breakdown":{"type":"object","properties":{"base_price":{"type":"string"},"final_price":{"type":"string"},"count_multiplier":{"type":"string"},"freshness_multiplier":{"type":"string"},"freshness_tier":{"type":"string"},"billing_strategy":{"type":"string"}},"required":["base_price","final_price","count_multiplier","freshness_multiplier","freshness_tier","billing_strategy"],"additionalProperties":false}},"required":["price","currency","network","pricing_model","pricing_dimensions","limit","availability","breakdown"],"additionalProperties":false}},{"name":"yodeler.preview_news_availability","title":"Preview news availability","description":"See how many rows are available and whether the query can be fetched for free.","annotations":{"readOnlyHint":true,"idempotentHint":true},"input_schema":{"type":"object","properties":{"channel":{"type":"integer","description":"Optional Telegram source channel id filter."},"since":{"type":"string","format":"date-time","description":"Optional lower-bound timestamp for freshness-aware pricing."},"limit":{"type":"integer","minimum":1,"maximum":500,"default":50,"description":"Maximum batch size to price and return."}},"additionalProperties":false},"output_schema":{"type":"object","properties":{"channel":{"type":"integer"},"since":{"type":"string","format":"date-time"},"limit":{"type":"integer"},"available_count":{"type":"integer"},"billable_count":{"type":"integer"},"is_free":{"type":"boolean"},"recommended_action":{"type":"string"},"quote":{"type":"object","properties":{"price":{"type":"string"},"currency":{"type":"string"},"network":{"type":"string"},"pay_to":{"type":"string"},"pricing_model":{"type":"string"},"pricing_dimensions":{"type":"array","items":{"type":"string"}},"limit":{"type":"integer"},"channel":{"type":"integer"},"since":{"type":"string","format":"date-time"},"availability":{"type":"object","properties":{"available_count":{"type":"integer"},"billable_count":{"type":"integer"},"is_free":{"type":"boolean"}},"required":["available_count","billable_count","is_free"],"additionalProperties":false},"breakdown":{"type":"object","properties":{"base_price":{"type":"string"},"final_price":{"type":"string"},"count_multiplier":{"type":"string"},"freshness_multiplier":{"type":"string"},"freshness_tier":{"type":"string"},"billing_strategy":{"type":"string"}},"required":["base_price","final_price","count_multiplier","freshness_multiplier","freshness_tier","billing_strategy"],"additionalProperties":false}},"required":["price","currency","network","pricing_model","pricing_dimensions","limit","availability","breakdown"],"additionalProperties":false}},"required":["limit","available_count","billable_count","is_free","recommended_action","quote"],"additionalProperties":false}},{"name":"yodeler.list_news_channels","title":"List source channels","description":"Browse the free catalog of source channels before buying batches.","annotations":{"readOnlyHint":true,"idempotentHint":true},"input_schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":50},"since":{"type":"string","format":"date-time"}},"additionalProperties":false},"output_schema":{"type":"object","properties":{"count":{"type":"integer"},"items":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"integer"},"message_count":{"type":"integer"},"newest_created_at":{"type":"string","format":"date-time"},"oldest_created_at":{"type":"string","format":"date-time"}},"required":["channel","message_count"],"additionalProperties":false}}},"required":["count","items"],"additionalProperties":false}},{"name":"yodeler.read_news_discovery_index","title":"Read discovery index","description":"Fetch all canonical Yodeler discovery URLs and marketplace metadata in one call.","annotations":{"readOnlyHint":true,"idempotentHint":true},"input_schema":{"type":"object","properties":{},"additionalProperties":false},"output_schema":{"type":"object","properties":{"service":{"type":"object"},"endpoints":{"type":"object"},"absolute_urls":{"type":"object"},"pricing":{"type":"object"},"distribution":{"type":"object"},"supported_networks":{"type":"array"},"json_ld":{"type":"object"}},"required":["service","endpoints","pricing","distribution","supported_networks"],"additionalProperties":false}},{"name":"yodeler.read_news_pricing","title":"Read news pricing card","description":"Read x402 pricing, settlement, preview, and free-empty-result semantics.","annotations":{"readOnlyHint":true,"idempotentHint":true},"input_schema":{"type":"object","properties":{},"additionalProperties":false},"output_schema":{"type":"object","properties":{"currency":{"type":"string"},"asset":{"type":"string"},"network":{"type":"string"},"scheme":{"type":"string"},"basePrice":{"type":"string"},"model":{"type":"string"},"dimensions":{"type":"array","items":{"type":"string"}},"billingStrategy":{"type":"string"},"freeOnEmptyResults":{"type":"boolean"}},"required":["currency","asset","network","scheme","basePrice","model","freeOnEmptyResults"],"additionalProperties":true}},{"name":"yodeler.list_intelligence_markets","title":"List intelligence markets","description":"Browse available and planned Yodeler intelligence products for agent buyers.","annotations":{"readOnlyHint":true,"idempotentHint":true},"input_schema":{"type":"object","properties":{},"additionalProperties":false},"output_schema":{"type":"object","properties":{"count":{"type":"integer"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"endpoint":{"type":"string"},"status":{"type":"string"},"access":{"type":"string"},"pricing_model":{"type":"string"},"best_for":{"type":"array","items":{"type":"string"}},"inputs":{"type":"array","items":{"type":"string"}},"outputs":{"type":"array","items":{"type":"string"}}},"required":["id","title","description","endpoint","status","access"],"additionalProperties":true}}},"required":["count","items"],"additionalProperties":true}},{"name":"yodeler.list_intelligence_sources","title":"List intelligence sources","description":"Browse source liquidity, freshness, and activity scores before buying news rows.","annotations":{"readOnlyHint":true,"idempotentHint":true},"input_schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":50},"since":{"type":"string","format":"date-time"}},"additionalProperties":false},"output_schema":{"type":"object","properties":{"count":{"type":"integer"},"items":{"type":"array","items":{"type":"object","properties":{"source_id":{"type":"integer"},"source_name":{"type":"string"},"platform":{"type":"string"},"source_type":{"type":"string"},"category":{"type":"string"},"message_count":{"type":"integer"},"newest_created_at":{"type":"string","format":"date-time"},"oldest_created_at":{"type":"string","format":"date-time"},"freshness":{"type":"string"},"activity_score":{"type":"number"},"reliability_score":{"type":"number"},"topics":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object"}},"required":["source_id","source_name","platform","message_count","freshness"],"additionalProperties":true}}},"required":["count","items"],"additionalProperties":false}},{"name":"yodeler.read_intelligence_stats","title":"Read intelligence market stats","description":"Read free market liquidity and freshness stats for buyer confidence.","annotations":{"readOnlyHint":true,"idempotentHint":true},"input_schema":{"type":"object","properties":{},"additionalProperties":false},"output_schema":{"type":"object","properties":{"stats":{"type":"object","properties":{"total_messages":{"type":"integer"},"total_sources":{"type":"integer"},"windows":{"type":"object"},"freshness":{"type":"object"},"market":{"type":"object"}},"required":["total_messages","total_sources","windows","freshness","market"],"additionalProperties":false}},"required":["stats"],"additionalProperties":false}}]}