{"openapi":"3.1.0","info":{"title":"Yodeler Data API","description":"\nQuery forwarded Telegram/Discord message logs from the database.\n\nThe `/v1/news` endpoint is designed to be monetized with x402 so clients can\npay per request before receiving message batches, while `/v1/news/quote`\nand `/v1/news/availability` expose free previews for agent workflows.\n\nDiscovery metadata is available through `/openapi.json` and\n`/.well-known/agent.json`, while `/v1/discovery` publishes the canonical\ndiscovery index for marketplaces and agent registries.\n\nEmpty result sets are returned for free, and `/v1/news/channels` offers a\nfree source-channel catalog so buyers can explore before paying.\n\nAgents can understand the tool contract,\npayment flow, supported networks, and pricing model automatically.\n","version":"dev","x-yodeler":{"agentDiscovery":{"manifestPath":"/.well-known/agent.json","x402DiscoveryPath":"/.well-known/x402.json","openapiPath":"/openapi.json","docsPath":"/docs","discoveryIndexPath":"/v1/discovery","pricingPath":"/v1/news/pricing","llmsPath":"/llms.txt","toolName":"yodeler.get_paid_news","quoteToolName":"yodeler.preview_news_quote","availabilityToolName":"yodeler.preview_news_availability","channelCatalogToolName":"yodeler.list_news_channels","pricingToolName":"yodeler.read_news_pricing","absoluteUrls":{"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"}},"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"},"configuredNetwork":{"id":"eip155:8453","label":"Base"},"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"}]},"jsonLd":{"@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"]}}}},"paths":{"/v1/intelligence/markets":{"get":{"tags":["intelligence"],"summary":"Browse intelligence products agents can buy or preview","description":"Return the market catalog for Yodeler's real-time intelligence products. Available markets are live now; planned markets document the premium event layer roadmap.","operationId":"get_intelligence_markets_v1_intelligence_markets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntelligenceMarketCatalogResponse"}}}}},"x-yodeler":{"agentReady":true,"discovery":{"manifestPath":"/.well-known/agent.json","openapiPath":"/openapi.json","docsPath":"/docs","discoveryIndexPath":"/v1/discovery","quotePath":"/v1/news/quote","availabilityPath":"/v1/news/availability","channelCatalogPath":"/v1/news/channels","funnelMetricsPath":"/v1/news/funnel","pricingPath":"/v1/news/pricing","spendSummaryPath":"/v1/news/spend","intelligenceMarketsPath":"/v1/intelligence/markets","intelligenceSourcesPath":"/v1/intelligence/sources","intelligenceStatsPath":"/v1/intelligence/stats","x402HealthPath":"/health/x402","termsPath":"/terms","privacyPath":"/privacy","dataProvenancePath":"/data-provenance","supportPath":"/support","x402DiscoveryPath":"/.well-known/x402.json","llmsPath":"/llms.txt","robotsPath":"/robots.txt","sitemapPath":"/sitemap.xml","toolName":"yodeler.get_paid_news","quoteToolName":"yodeler.preview_news_quote","availabilityToolName":"yodeler.preview_news_availability","channelCatalogToolName":"yodeler.list_news_channels","discoveryToolName":"yodeler.read_news_discovery_index","pricingToolName":"yodeler.read_news_pricing","intelligenceMarketsToolName":"yodeler.list_intelligence_markets","intelligenceSourcesToolName":"yodeler.list_intelligence_sources","intelligenceStatsToolName":"yodeler.read_intelligence_stats","absoluteUrls":{"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"}},"supportedNetworks":[{"id":"eip155:8453","label":"Base","configured":true},{"id":"eip155:84532","label":"Base Sepolia","configured":false}],"paymentFlow":[{"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"}],"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"},"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"}]}},"x-mcp-tool":{"name":"yodeler.list_intelligence_markets","title":"List intelligence markets","annotations":{"readOnlyHint":true,"idempotentHint":true},"inputSchema":{"type":"object","properties":{},"additionalProperties":false}}}},"/v1/intelligence/sources":{"get":{"tags":["intelligence"],"summary":"Browse source liquidity for the intelligence market","description":"Return agent-readable source summaries with message counts, freshness labels, and activity scores so buyers can decide what is worth querying before paying for raw news rows.","operationId":"get_intelligence_sources_v1_intelligence_sources_get","parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Optional lower-bound timestamp for source activity.","title":"Since"},"description":"Optional lower-bound timestamp for source activity."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum number of source summaries to return.","default":50,"title":"Limit"},"description":"Maximum number of source summaries to return."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntelligenceSourceCatalogResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-yodeler":{"agentReady":true,"discovery":{"manifestPath":"/.well-known/agent.json","openapiPath":"/openapi.json","docsPath":"/docs","discoveryIndexPath":"/v1/discovery","quotePath":"/v1/news/quote","availabilityPath":"/v1/news/availability","channelCatalogPath":"/v1/news/channels","funnelMetricsPath":"/v1/news/funnel","pricingPath":"/v1/news/pricing","spendSummaryPath":"/v1/news/spend","intelligenceMarketsPath":"/v1/intelligence/markets","intelligenceSourcesPath":"/v1/intelligence/sources","intelligenceStatsPath":"/v1/intelligence/stats","x402HealthPath":"/health/x402","termsPath":"/terms","privacyPath":"/privacy","dataProvenancePath":"/data-provenance","supportPath":"/support","x402DiscoveryPath":"/.well-known/x402.json","llmsPath":"/llms.txt","robotsPath":"/robots.txt","sitemapPath":"/sitemap.xml","toolName":"yodeler.get_paid_news","quoteToolName":"yodeler.preview_news_quote","availabilityToolName":"yodeler.preview_news_availability","channelCatalogToolName":"yodeler.list_news_channels","discoveryToolName":"yodeler.read_news_discovery_index","pricingToolName":"yodeler.read_news_pricing","intelligenceMarketsToolName":"yodeler.list_intelligence_markets","intelligenceSourcesToolName":"yodeler.list_intelligence_sources","intelligenceStatsToolName":"yodeler.read_intelligence_stats","absoluteUrls":{"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"}},"supportedNetworks":[{"id":"eip155:8453","label":"Base","configured":true},{"id":"eip155:84532","label":"Base Sepolia","configured":false}],"paymentFlow":[{"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"}],"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"},"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"}]}},"x-mcp-tool":{"name":"yodeler.list_intelligence_sources","title":"List intelligence sources","annotations":{"readOnlyHint":true,"idempotentHint":true},"inputSchema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":50},"since":{"type":"string","format":"date-time"}},"additionalProperties":false}}}},"/v1/intelligence/stats":{"get":{"tags":["intelligence"],"summary":"Read intelligence market liquidity and freshness stats","description":"Return free public inventory metrics for agent buyer confidence, including total rows, active sources, recent-window counts, and freshness of the newest stored signal.","operationId":"get_intelligence_stats_v1_intelligence_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntelligenceStatsResponse"}}}}},"x-yodeler":{"agentReady":true,"discovery":{"manifestPath":"/.well-known/agent.json","openapiPath":"/openapi.json","docsPath":"/docs","discoveryIndexPath":"/v1/discovery","quotePath":"/v1/news/quote","availabilityPath":"/v1/news/availability","channelCatalogPath":"/v1/news/channels","funnelMetricsPath":"/v1/news/funnel","pricingPath":"/v1/news/pricing","spendSummaryPath":"/v1/news/spend","intelligenceMarketsPath":"/v1/intelligence/markets","intelligenceSourcesPath":"/v1/intelligence/sources","intelligenceStatsPath":"/v1/intelligence/stats","x402HealthPath":"/health/x402","termsPath":"/terms","privacyPath":"/privacy","dataProvenancePath":"/data-provenance","supportPath":"/support","x402DiscoveryPath":"/.well-known/x402.json","llmsPath":"/llms.txt","robotsPath":"/robots.txt","sitemapPath":"/sitemap.xml","toolName":"yodeler.get_paid_news","quoteToolName":"yodeler.preview_news_quote","availabilityToolName":"yodeler.preview_news_availability","channelCatalogToolName":"yodeler.list_news_channels","discoveryToolName":"yodeler.read_news_discovery_index","pricingToolName":"yodeler.read_news_pricing","intelligenceMarketsToolName":"yodeler.list_intelligence_markets","intelligenceSourcesToolName":"yodeler.list_intelligence_sources","intelligenceStatsToolName":"yodeler.read_intelligence_stats","absoluteUrls":{"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"}},"supportedNetworks":[{"id":"eip155:8453","label":"Base","configured":true},{"id":"eip155:84532","label":"Base Sepolia","configured":false}],"paymentFlow":[{"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"}],"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"},"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"}]}},"x-mcp-tool":{"name":"yodeler.read_intelligence_stats","title":"Read intelligence market stats","annotations":{"readOnlyHint":true,"idempotentHint":true},"inputSchema":{"type":"object","properties":{},"additionalProperties":false}}}},"/v1/news/quote":{"get":{"tags":["news"],"summary":"Preview x402 price only for a news query","description":"Return a deterministic price preview for a potential `/v1/news` request without paid rows. This is the price-only preview. Prefer `/v1/news/availability` for most agent flows, since it returns this same quote plus the free-result check and `X-Max-Price` budget guard. Use `/v1/news/quote` only when you want the price without availability details.","operationId":"get_news_quote_v1_news_quote_get","parameters":[{"name":"channel","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Filter by Telegram source channel id.","title":"Channel"},"description":"Filter by Telegram source channel id."},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Price against rows created at or after this ISO-8601 timestamp.","title":"Since"},"description":"Price against rows created at or after this ISO-8601 timestamp."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Batch size to price. The effective cap is controlled by X402_NEWS_MAX_LIMIT.","title":"Limit"},"description":"Batch size to price. The effective cap is controlled by X402_NEWS_MAX_LIMIT."},{"name":"if-none-match","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Return HTTP 304 for free when the quoted pricing is unchanged.","title":"If-None-Match"},"description":"Return HTTP 304 for free when the quoted pricing is unchanged."}],"responses":{"200":{"description":"Deterministic x402 quote preview for a news query.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsQuoteResponse"},"example":{"price":"$0.02","currency":"USD","network":"eip155:8453","pay_to":"0x1111111111111111111111111111111111111111","pricing_model":"availability-aware-count-and-freshness","pricing_dimensions":["billable_count","freshness"],"limit":200,"channel":123,"since":"2026-05-01T12:00:00Z","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"}}}}},"503":{"description":"Paid news is unavailable because the seller wallet is not configured."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-yodeler":{"agentReady":true,"discovery":{"manifestPath":"/.well-known/agent.json","openapiPath":"/openapi.json","docsPath":"/docs","discoveryIndexPath":"/v1/discovery","quotePath":"/v1/news/quote","availabilityPath":"/v1/news/availability","channelCatalogPath":"/v1/news/channels","funnelMetricsPath":"/v1/news/funnel","pricingPath":"/v1/news/pricing","spendSummaryPath":"/v1/news/spend","intelligenceMarketsPath":"/v1/intelligence/markets","intelligenceSourcesPath":"/v1/intelligence/sources","intelligenceStatsPath":"/v1/intelligence/stats","x402HealthPath":"/health/x402","termsPath":"/terms","privacyPath":"/privacy","dataProvenancePath":"/data-provenance","supportPath":"/support","x402DiscoveryPath":"/.well-known/x402.json","llmsPath":"/llms.txt","robotsPath":"/robots.txt","sitemapPath":"/sitemap.xml","toolName":"yodeler.get_paid_news","quoteToolName":"yodeler.preview_news_quote","availabilityToolName":"yodeler.preview_news_availability","channelCatalogToolName":"yodeler.list_news_channels","discoveryToolName":"yodeler.read_news_discovery_index","pricingToolName":"yodeler.read_news_pricing","intelligenceMarketsToolName":"yodeler.list_intelligence_markets","intelligenceSourcesToolName":"yodeler.list_intelligence_sources","intelligenceStatsToolName":"yodeler.read_intelligence_stats","absoluteUrls":{"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"}},"supportedNetworks":[{"id":"eip155:8453","label":"Base","configured":true},{"id":"eip155:84532","label":"Base Sepolia","configured":false}],"paymentFlow":[{"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"}],"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"},"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"}]}},"x-mcp-tool":{"name":"yodeler.preview_news_quote","title":"Preview x402 quote","annotations":{"readOnlyHint":true,"idempotentHint":true},"inputSchema":{"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}}}},"/v1/news/availability":{"get":{"tags":["news"],"summary":"Preview availability, free-status, and price (recommended pre-purchase call)","description":"Recommended single pre-purchase call for agents. Counts the rows available for a potential `/v1/news` request, reports whether the result set would be free, embeds the exact availability-aware x402 quote (a superset of `/v1/news/quote`), and honors the optional `X-Max-Price` budget header.","operationId":"get_news_availability_v1_news_availability_get","parameters":[{"name":"channel","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Filter by Telegram source channel id.","title":"Channel"},"description":"Filter by Telegram source channel id."},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Preview availability for rows created at or after this ISO-8601 timestamp.","title":"Since"},"description":"Preview availability for rows created at or after this ISO-8601 timestamp."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Maximum number of rows to inspect for billing and delivery.","title":"Limit"},"description":"Maximum number of rows to inspect for billing and delivery."},{"name":"if-none-match","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Return HTTP 304 for free when availability and pricing are unchanged.","title":"If-None-Match"},"description":"Return HTTP 304 for free when availability and pricing are unchanged."},{"name":"x-max-price","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Agent budget ceiling (e.g. '$0.05'); response reports whether the quote fits.","title":"X-Max-Price"},"description":"Agent budget ceiling (e.g. '$0.05'); response reports whether the quote fits."}],"responses":{"200":{"description":"Availability preview plus embedded quote data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsAvailabilityResponse"},"example":{"channel":123,"since":"2026-05-01T12:00:00Z","limit":200,"available_count":180,"billable_count":180,"is_free":false,"recommended_action":"pay-and-fetch","quote":{"price":"$0.02","currency":"USD","network":"eip155:8453","pay_to":"0x1111111111111111111111111111111111111111","pricing_model":"availability-aware-count-and-freshness","pricing_dimensions":["billable_count","freshness"],"limit":200,"channel":123,"since":"2026-05-01T12:00:00Z","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"}}}}}},"503":{"description":"Paid news is unavailable because the seller wallet is not configured."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-yodeler":{"agentReady":true,"discovery":{"manifestPath":"/.well-known/agent.json","openapiPath":"/openapi.json","docsPath":"/docs","discoveryIndexPath":"/v1/discovery","quotePath":"/v1/news/quote","availabilityPath":"/v1/news/availability","channelCatalogPath":"/v1/news/channels","funnelMetricsPath":"/v1/news/funnel","pricingPath":"/v1/news/pricing","spendSummaryPath":"/v1/news/spend","intelligenceMarketsPath":"/v1/intelligence/markets","intelligenceSourcesPath":"/v1/intelligence/sources","intelligenceStatsPath":"/v1/intelligence/stats","x402HealthPath":"/health/x402","termsPath":"/terms","privacyPath":"/privacy","dataProvenancePath":"/data-provenance","supportPath":"/support","x402DiscoveryPath":"/.well-known/x402.json","llmsPath":"/llms.txt","robotsPath":"/robots.txt","sitemapPath":"/sitemap.xml","toolName":"yodeler.get_paid_news","quoteToolName":"yodeler.preview_news_quote","availabilityToolName":"yodeler.preview_news_availability","channelCatalogToolName":"yodeler.list_news_channels","discoveryToolName":"yodeler.read_news_discovery_index","pricingToolName":"yodeler.read_news_pricing","intelligenceMarketsToolName":"yodeler.list_intelligence_markets","intelligenceSourcesToolName":"yodeler.list_intelligence_sources","intelligenceStatsToolName":"yodeler.read_intelligence_stats","absoluteUrls":{"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"}},"supportedNetworks":[{"id":"eip155:8453","label":"Base","configured":true},{"id":"eip155:84532","label":"Base Sepolia","configured":false}],"paymentFlow":[{"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"}],"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"},"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"}]}},"x-mcp-tool":{"name":"yodeler.preview_news_availability","title":"Preview news availability","annotations":{"readOnlyHint":true,"idempotentHint":true},"inputSchema":{"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}}}},"/v1/news/channels":{"get":{"tags":["news"],"summary":"Browse the free source channel catalog","description":"Return distinct source channels with message counts and time coverage so agent clients can discover available news streams before buying batches.","operationId":"get_news_channels_v1_news_channels_get","parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Optional lower-bound timestamp for channel activity.","title":"Since"},"description":"Optional lower-bound timestamp for channel activity."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum number of channel summaries to return.","default":50,"title":"Limit"},"description":"Maximum number of channel summaries to return."},{"name":"if-none-match","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Return HTTP 304 for free when the channel catalog is unchanged.","title":"If-None-Match"},"description":"Return HTTP 304 for free when the channel catalog is unchanged."}],"responses":{"200":{"description":"Free source-channel catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsChannelCatalogResponse"},"example":{"count":2,"items":[{"channel":123,"message_count":42,"newest_created_at":"2026-05-01T12:00:00Z","oldest_created_at":"2026-04-01T12:00:00Z"},{"channel":456,"message_count":12,"newest_created_at":"2026-05-01T08:00:00Z","oldest_created_at":"2026-04-28T09:30:00Z"}]}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-yodeler":{"agentReady":true,"discovery":{"manifestPath":"/.well-known/agent.json","openapiPath":"/openapi.json","docsPath":"/docs","discoveryIndexPath":"/v1/discovery","quotePath":"/v1/news/quote","availabilityPath":"/v1/news/availability","channelCatalogPath":"/v1/news/channels","funnelMetricsPath":"/v1/news/funnel","pricingPath":"/v1/news/pricing","spendSummaryPath":"/v1/news/spend","intelligenceMarketsPath":"/v1/intelligence/markets","intelligenceSourcesPath":"/v1/intelligence/sources","intelligenceStatsPath":"/v1/intelligence/stats","x402HealthPath":"/health/x402","termsPath":"/terms","privacyPath":"/privacy","dataProvenancePath":"/data-provenance","supportPath":"/support","x402DiscoveryPath":"/.well-known/x402.json","llmsPath":"/llms.txt","robotsPath":"/robots.txt","sitemapPath":"/sitemap.xml","toolName":"yodeler.get_paid_news","quoteToolName":"yodeler.preview_news_quote","availabilityToolName":"yodeler.preview_news_availability","channelCatalogToolName":"yodeler.list_news_channels","discoveryToolName":"yodeler.read_news_discovery_index","pricingToolName":"yodeler.read_news_pricing","intelligenceMarketsToolName":"yodeler.list_intelligence_markets","intelligenceSourcesToolName":"yodeler.list_intelligence_sources","intelligenceStatsToolName":"yodeler.read_intelligence_stats","absoluteUrls":{"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"}},"supportedNetworks":[{"id":"eip155:8453","label":"Base","configured":true},{"id":"eip155:84532","label":"Base Sepolia","configured":false}],"paymentFlow":[{"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"}],"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"},"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"}]}},"x-mcp-tool":{"name":"yodeler.list_news_channels","title":"List source channels","annotations":{"readOnlyHint":true,"idempotentHint":true},"inputSchema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":50},"since":{"type":"string","format":"date-time"}},"additionalProperties":false}}}},"/v1/news/pricing":{"get":{"tags":["news"],"summary":"Read x402 pricing and settlement metadata","description":"Return a free pricing card for crawler, marketplace, and agent discovery. Includes scheme, network, asset, tiers, free-empty-result behavior, and preview endpoints.","operationId":"get_news_pricing_v1_news_pricing_get","responses":{"200":{"description":"Machine-readable x402 pricing card for Yodeler news.","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get News Pricing V1 News Pricing Get"}}}}},"x-yodeler":{"agentReady":true,"discovery":{"manifestPath":"/.well-known/agent.json","openapiPath":"/openapi.json","docsPath":"/docs","discoveryIndexPath":"/v1/discovery","quotePath":"/v1/news/quote","availabilityPath":"/v1/news/availability","channelCatalogPath":"/v1/news/channels","funnelMetricsPath":"/v1/news/funnel","pricingPath":"/v1/news/pricing","spendSummaryPath":"/v1/news/spend","intelligenceMarketsPath":"/v1/intelligence/markets","intelligenceSourcesPath":"/v1/intelligence/sources","intelligenceStatsPath":"/v1/intelligence/stats","x402HealthPath":"/health/x402","termsPath":"/terms","privacyPath":"/privacy","dataProvenancePath":"/data-provenance","supportPath":"/support","x402DiscoveryPath":"/.well-known/x402.json","llmsPath":"/llms.txt","robotsPath":"/robots.txt","sitemapPath":"/sitemap.xml","toolName":"yodeler.get_paid_news","quoteToolName":"yodeler.preview_news_quote","availabilityToolName":"yodeler.preview_news_availability","channelCatalogToolName":"yodeler.list_news_channels","discoveryToolName":"yodeler.read_news_discovery_index","pricingToolName":"yodeler.read_news_pricing","intelligenceMarketsToolName":"yodeler.list_intelligence_markets","intelligenceSourcesToolName":"yodeler.list_intelligence_sources","intelligenceStatsToolName":"yodeler.read_intelligence_stats","absoluteUrls":{"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"}},"supportedNetworks":[{"id":"eip155:8453","label":"Base","configured":true},{"id":"eip155:84532","label":"Base Sepolia","configured":false}],"paymentFlow":[{"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"}],"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"},"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"}]}},"x-mcp-tool":{"name":"yodeler.read_news_pricing","title":"Read news pricing card","annotations":{"readOnlyHint":true,"idempotentHint":true},"inputSchema":{"type":"object","properties":{},"additionalProperties":false}}}},"/v1/news/spend":{"get":{"tags":["news"],"summary":"Read aggregate paid news spend totals","description":"Return aggregate accounting totals from the durable news purchase ledger. Raw buyer rows stay in the database; this endpoint only reports grouped totals.","operationId":"get_news_spend_v1_news_spend_get","responses":{"200":{"description":"Aggregate purchase and spend totals grouped by currency, network, and asset.","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get News Spend V1 News Spend Get"}}}}}}},"/v1/news/sandbox":{"get":{"tags":["news"],"summary":"Fetch a free synthetic news batch for integration testing","description":"Return a free, schema-valid synthetic batch shaped exactly like the paid `/v1/news` response so agents and developers can build and test their integration without spending anything.","operationId":"get_news_sandbox_v1_news_sandbox_get","parameters":[{"name":"channel","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Optional source channel id to echo in synthetic rows.","title":"Channel"},"description":"Optional source channel id to echo in synthetic rows."},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Optional ISO-8601 lower-bound echoed in the synthetic response metadata.","title":"Since"},"description":"Optional ISO-8601 lower-bound echoed in the synthetic response metadata."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Synthetic batch size. The effective cap is controlled by X402_NEWS_MAX_LIMIT.","title":"Limit"},"description":"Synthetic batch size. The effective cap is controlled by X402_NEWS_MAX_LIMIT."},{"name":"rows","in":"query","required":false,"schema":{"type":"integer","maximum":25,"minimum":0,"description":"Number of synthetic rows to generate.","default":3,"title":"Rows"},"description":"Number of synthetic rows to generate."}],"responses":{"200":{"description":"Free synthetic batch matching the paid news response schema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsResponse"},"example":{"count":1,"items":[{"id":"01961c1b-cf6f-77ec-b66d-c6ef2819dd86","source_id":123,"destination_type":"telegram","destination_id":456,"message_text":"Breaking news: Yodeler forwarded another headline.","created_at":"2026-05-01T12:00:00Z"}],"meta":{"channel":123,"since":"2026-05-01T12:00:00Z","limit":200,"available_count":180,"billable_count":180,"is_free":false,"delivery_mode":"paid","sort":"created_at_desc","has_more":true,"next_cursor":"eyJjcmVhdGVkX2F0IjoiMjAyNi0wNS0wMVQxMjowMDowMCswMDowMCIsImlkIjoiMDE5NjFjMWItY2Y2Zi03N2VjLWI2NmQtYzZlZjI4MTlkZDg2In0","quote_id":"news_5f25b7aab0f8c302","pricing_hash":"5f25b7aab0f8c3029c9a7e708c0f2cb0ad3c8f7d12253ec48f0f3e927af1cc19d"},"window":{"newest_created_at":"2026-05-01T12:00:00Z","oldest_created_at":"2026-05-01T12:00:00Z"},"payment":{"scheme":"exact","network":"eip155:8453","currency":"USD","pay_to":"0x1111111111111111111111111111111111111111","asset":"0x833589fCD6EDb6E08f4c7C32D4f71b54bdA02913","amount":"10000","price":"$0.01"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/news":{"get":{"tags":["news"],"summary":"Get paid news rows","description":"Return a paid batch of forwarded message rows. The route is protected by x402 and charges from the actual billable row count and the freshness implied by `since`. Call `/v1/news/availability` first if your client wants to know whether the query is free.","operationId":"get_news_v1_news_get","parameters":[{"name":"channel","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Filter by Telegram source channel id.","title":"Channel"},"description":"Filter by Telegram source channel id."},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Return rows created at or after this ISO-8601 timestamp.","title":"Since"},"description":"Return rows created at or after this ISO-8601 timestamp."},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"description":"Maximum number of rows to return. The effective cap is controlled by X402_NEWS_MAX_LIMIT.","title":"Limit"},"description":"Maximum number of rows to return. The effective cap is controlled by X402_NEWS_MAX_LIMIT."},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor returned as `meta.next_cursor` for deterministic created_at-desc pagination.","title":"Cursor"},"description":"Opaque cursor returned as `meta.next_cursor` for deterministic created_at-desc pagination."}],"responses":{"200":{"description":"Paid batch of news rows after x402 verification.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsResponse"},"example":{"count":1,"items":[{"id":"01961c1b-cf6f-77ec-b66d-c6ef2819dd86","source_id":123,"destination_type":"telegram","destination_id":456,"message_text":"Breaking news: Yodeler forwarded another headline.","created_at":"2026-05-01T12:00:00Z"}],"meta":{"channel":123,"since":"2026-05-01T12:00:00Z","limit":200,"available_count":180,"billable_count":180,"is_free":false,"delivery_mode":"paid","sort":"created_at_desc","has_more":true,"next_cursor":"eyJjcmVhdGVkX2F0IjoiMjAyNi0wNS0wMVQxMjowMDowMCswMDowMCIsImlkIjoiMDE5NjFjMWItY2Y2Zi03N2VjLWI2NmQtYzZlZjI4MTlkZDg2In0","quote_id":"news_5f25b7aab0f8c302","pricing_hash":"5f25b7aab0f8c3029c9a7e708c0f2cb0ad3c8f7d12253ec48f0f3e927af1cc19d"},"window":{"newest_created_at":"2026-05-01T12:00:00Z","oldest_created_at":"2026-05-01T12:00:00Z"},"payment":{"scheme":"exact","network":"eip155:8453","currency":"USD","pay_to":"0x1111111111111111111111111111111111111111","asset":"0x833589fCD6EDb6E08f4c7C32D4f71b54bdA02913","amount":"10000","price":"$0.01"}}}}},"402":{"description":"Payment required. Retry with a valid x402 payment payload after inspecting the quoted requirements.","headers":{"payment-required":{"description":"Base64-encoded x402 payment terms for the request.","schema":{"type":"string"}}},"content":{"application/json":{"example":{}}}},"503":{"description":"Paid news is unavailable because the seller wallet is not configured."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-yodeler":{"agentReady":true,"discovery":{"manifestPath":"/.well-known/agent.json","openapiPath":"/openapi.json","docsPath":"/docs","discoveryIndexPath":"/v1/discovery","quotePath":"/v1/news/quote","availabilityPath":"/v1/news/availability","channelCatalogPath":"/v1/news/channels","funnelMetricsPath":"/v1/news/funnel","pricingPath":"/v1/news/pricing","spendSummaryPath":"/v1/news/spend","intelligenceMarketsPath":"/v1/intelligence/markets","intelligenceSourcesPath":"/v1/intelligence/sources","intelligenceStatsPath":"/v1/intelligence/stats","x402HealthPath":"/health/x402","termsPath":"/terms","privacyPath":"/privacy","dataProvenancePath":"/data-provenance","supportPath":"/support","x402DiscoveryPath":"/.well-known/x402.json","llmsPath":"/llms.txt","robotsPath":"/robots.txt","sitemapPath":"/sitemap.xml","toolName":"yodeler.get_paid_news","quoteToolName":"yodeler.preview_news_quote","availabilityToolName":"yodeler.preview_news_availability","channelCatalogToolName":"yodeler.list_news_channels","discoveryToolName":"yodeler.read_news_discovery_index","pricingToolName":"yodeler.read_news_pricing","intelligenceMarketsToolName":"yodeler.list_intelligence_markets","intelligenceSourcesToolName":"yodeler.list_intelligence_sources","intelligenceStatsToolName":"yodeler.read_intelligence_stats","absoluteUrls":{"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"}},"supportedNetworks":[{"id":"eip155:8453","label":"Base","configured":true},{"id":"eip155:84532","label":"Base Sepolia","configured":false}],"paymentFlow":[{"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"}],"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"},"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"}]}},"x-mcp-tool":{"name":"yodeler.get_paid_news","title":"Buy paid news rows","annotations":{"readOnlyHint":true,"idempotentHint":true},"inputSchema":{"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}}}},"/.well-known/agent.json":{"get":{"tags":["discovery"],"summary":"Read the Yodeler agent discovery manifest","description":"Machine-readable metadata for agent frameworks, MCP-style tool wrappers, and directory submissions. Includes pricing, payment flow, tool schemas, and supported network hints.","operationId":"get_agent_manifest__well_known_agent_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Agent Manifest  Well Known Agent Json Get"}}}}},"x-mcp-tool":{"name":"yodeler.read_agent_manifest","annotations":{"readOnlyHint":true,"idempotentHint":true}}}},"/.well-known/x402.json":{"get":{"tags":["discovery"],"summary":"Read the x402 discovery document","description":"Compact x402-native discovery document for payment-aware crawlers, agent runtimes, and marketplaces. Includes protected resources, pricing pointers, network, asset, and JSON-LD.","operationId":"get_x402_discovery__well_known_x402_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get X402 Discovery  Well Known X402 Json Get"}}}}}}},"/v1/discovery":{"get":{"tags":["discovery"],"summary":"Read the Yodeler discovery index","description":"Canonical index of Yodeler discovery endpoints, marketplace metadata, pricing model details, and supported networks.","operationId":"get_discovery_index_v1_discovery_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Discovery Index V1 Discovery Get"}}}}},"x-yodeler":{"agentReady":true,"discovery":{"manifestPath":"/.well-known/agent.json","openapiPath":"/openapi.json","docsPath":"/docs","discoveryIndexPath":"/v1/discovery","quotePath":"/v1/news/quote","availabilityPath":"/v1/news/availability","channelCatalogPath":"/v1/news/channels","funnelMetricsPath":"/v1/news/funnel","pricingPath":"/v1/news/pricing","spendSummaryPath":"/v1/news/spend","intelligenceMarketsPath":"/v1/intelligence/markets","intelligenceSourcesPath":"/v1/intelligence/sources","intelligenceStatsPath":"/v1/intelligence/stats","x402HealthPath":"/health/x402","termsPath":"/terms","privacyPath":"/privacy","dataProvenancePath":"/data-provenance","supportPath":"/support","x402DiscoveryPath":"/.well-known/x402.json","llmsPath":"/llms.txt","robotsPath":"/robots.txt","sitemapPath":"/sitemap.xml","toolName":"yodeler.get_paid_news","quoteToolName":"yodeler.preview_news_quote","availabilityToolName":"yodeler.preview_news_availability","channelCatalogToolName":"yodeler.list_news_channels","discoveryToolName":"yodeler.read_news_discovery_index","pricingToolName":"yodeler.read_news_pricing","intelligenceMarketsToolName":"yodeler.list_intelligence_markets","intelligenceSourcesToolName":"yodeler.list_intelligence_sources","intelligenceStatsToolName":"yodeler.read_intelligence_stats","absoluteUrls":{"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"}},"supportedNetworks":[{"id":"eip155:8453","label":"Base","configured":true},{"id":"eip155:84532","label":"Base Sepolia","configured":false}],"paymentFlow":[{"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"}],"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"},"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"}]}},"x-mcp-tool":{"name":"yodeler.read_news_discovery_index","title":"Read discovery index","annotations":{"readOnlyHint":true,"idempotentHint":true},"inputSchema":{"type":"object","properties":{},"additionalProperties":false}}}},"/v1/license":{"get":{"tags":["discovery"],"summary":"Read the machine-readable data license","description":"Return the usage rights for delivered news data so agents can programmatically decide whether they may redistribute, embed, or train on purchased rows.","operationId":"get_data_license_v1_license_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Data License V1 License Get"}}}}}}},"/v1/news/funnel":{"get":{"tags":["metrics"],"summary":"Read lightweight funnel metrics","description":"Simple in-process funnel metrics for quote previews, availability checks, 402 challenges, free empty fetches, and successful paid fetches.","operationId":"get_funnel_metrics_v1_news_funnel_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Funnel Metrics V1 News Funnel Get"}}}}}}},"/llms.txt":{"get":{"tags":["discovery"],"summary":"Read LLM crawler instructions","description":"Concise llms.txt guidance for AI agents and generative search crawlers.","operationId":"get_llms_txt_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/health/x402":{"get":{"tags":["health"],"summary":"Check x402 payment readiness","description":"Report seller wallet configuration, configured x402 scheme/network/asset, facilitator URL, and whether the facilitator advertises support for the configured exact-payment network.","operationId":"x402_health_check_health_x402_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response X402 Health Check Health X402 Get"}}}}}}},"/about":{"get":{"tags":["discovery"],"summary":"Read the public Yodeler News API overview","description":"Crawlable, semantic HTML overview for humans, search engines, and browser agents. Links to canonical discovery, pricing, preview, x402, trust, and API documentation resources.","operationId":"get_news_landing_page_about_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/terms":{"get":{"tags":["discovery"],"summary":"Get Terms","description":"Return lightweight terms so buyers understand paid-data usage expectations.","operationId":"get_terms_terms_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/privacy":{"get":{"tags":["discovery"],"summary":"Get Privacy","description":"Return privacy notes so buyers know what request metadata is recorded.","operationId":"get_privacy_privacy_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/data-provenance":{"get":{"tags":["discovery"],"summary":"Get Data Provenance","description":"Return data provenance so buyers understand where paid rows originate.","operationId":"get_data_provenance_data_provenance_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/support":{"get":{"tags":["discovery"],"summary":"Get Support","description":"Return support guidance so agents can find operational readiness signals.","operationId":"get_support_support_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/health":{"get":{"tags":["health"],"summary":"Health Check","description":"Return basic health so orchestration can check the API without dependencies.","operationId":"health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Health Check Health Get"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"IntelligenceFreshnessStats":{"properties":{"newest_created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Newest Created At"},"oldest_created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Oldest Created At"},"newest_age_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Newest Age Seconds"}},"type":"object","title":"IntelligenceFreshnessStats","description":"Freshness coverage for the current intelligence inventory."},"IntelligenceMarket":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"endpoint":{"type":"string","title":"Endpoint"},"status":{"type":"string","title":"Status"},"access":{"type":"string","title":"Access"},"pricing_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pricing Model"},"best_for":{"items":{"type":"string"},"type":"array","title":"Best For"},"inputs":{"items":{"type":"string"},"type":"array","title":"Inputs"},"outputs":{"items":{"type":"string"},"type":"array","title":"Outputs"}},"type":"object","required":["id","title","description","endpoint","status","access","best_for","inputs","outputs"],"title":"IntelligenceMarket","description":"A marketable intelligence product exposed to agent buyers."},"IntelligenceMarketCatalogResponse":{"properties":{"count":{"type":"integer","title":"Count"},"items":{"items":{"$ref":"#/components/schemas/IntelligenceMarket"},"type":"array","title":"Items"}},"type":"object","required":["count","items"],"title":"IntelligenceMarketCatalogResponse","description":"Catalog of available and planned intelligence markets."},"IntelligenceMarketStats":{"properties":{"total_messages":{"type":"integer","title":"Total Messages"},"total_sources":{"type":"integer","title":"Total Sources"},"windows":{"additionalProperties":{"$ref":"#/components/schemas/IntelligenceStatsWindow"},"type":"object","title":"Windows"},"freshness":{"$ref":"#/components/schemas/IntelligenceFreshnessStats"},"market":{"additionalProperties":true,"type":"object","title":"Market"}},"type":"object","required":["total_messages","total_sources","windows","freshness","market"],"title":"IntelligenceMarketStats","description":"Public market/liquidity stats for agent buyer confidence."},"IntelligenceSource":{"properties":{"source_id":{"type":"integer","title":"Source Id"},"source_name":{"type":"string","title":"Source Name"},"platform":{"type":"string","title":"Platform"},"source_type":{"type":"string","title":"Source Type"},"category":{"type":"string","title":"Category"},"message_count":{"type":"integer","title":"Message Count"},"newest_created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Newest Created At"},"oldest_created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Oldest Created At"},"freshness":{"type":"string","title":"Freshness"},"activity_score":{"type":"number","title":"Activity Score"},"reliability_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reliability Score"},"topics":{"items":{"type":"string"},"type":"array","title":"Topics"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["source_id","source_name","platform","source_type","category","message_count","freshness","activity_score","topics","metadata"],"title":"IntelligenceSource","description":"Agent-readable source summary for the intelligence market."},"IntelligenceSourceCatalogResponse":{"properties":{"count":{"type":"integer","title":"Count"},"items":{"items":{"$ref":"#/components/schemas/IntelligenceSource"},"type":"array","title":"Items"}},"type":"object","required":["count","items"],"title":"IntelligenceSourceCatalogResponse","description":"Free source catalog for agents deciding what intelligence to buy."},"IntelligenceStatsResponse":{"properties":{"stats":{"$ref":"#/components/schemas/IntelligenceMarketStats"}},"type":"object","required":["stats"],"title":"IntelligenceStatsResponse","description":"Free stats response describing market liquidity and freshness."},"IntelligenceStatsWindow":{"properties":{"messages":{"type":"integer","title":"Messages"},"active_sources":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Active Sources"}},"type":"object","required":["messages"],"title":"IntelligenceStatsWindow","description":"Message and source liquidity metrics for a time window."},"MessageLogResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"source_id":{"type":"integer","title":"Source Id"},"destination_type":{"type":"string","title":"Destination Type"},"destination_id":{"type":"integer","title":"Destination Id"},"message_text":{"type":"string","title":"Message Text"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","source_id","destination_type","destination_id","message_text"],"title":"MessageLogResponse","description":"Serialized message log row returned by the paid API."},"NewsAvailabilityResponse":{"properties":{"channel":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Channel"},"since":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Since"},"limit":{"type":"integer","title":"Limit"},"available_count":{"type":"integer","title":"Available Count"},"billable_count":{"type":"integer","title":"Billable Count"},"is_free":{"type":"boolean","title":"Is Free"},"recommended_action":{"type":"string","title":"Recommended Action"},"within_budget":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Within Budget"},"max_price":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Max Price"},"quote":{"$ref":"#/components/schemas/NewsQuoteResponse"}},"type":"object","required":["limit","available_count","billable_count","is_free","recommended_action","quote"],"title":"NewsAvailabilityResponse","description":"Free availability preview for the paid news endpoint."},"NewsBatchWindow":{"properties":{"newest_created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Newest Created At"},"oldest_created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Oldest Created At"}},"type":"object","title":"NewsBatchWindow","description":"Time window covered by the returned batch."},"NewsChannelCatalogItem":{"properties":{"channel":{"type":"integer","title":"Channel"},"message_count":{"type":"integer","title":"Message Count"},"newest_created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Newest Created At"},"oldest_created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Oldest Created At"}},"type":"object","required":["channel","message_count"],"title":"NewsChannelCatalogItem","description":"Summary row for a source channel in the free catalog."},"NewsChannelCatalogResponse":{"properties":{"count":{"type":"integer","title":"Count"},"items":{"items":{"$ref":"#/components/schemas/NewsChannelCatalogItem"},"type":"array","title":"Items"}},"type":"object","required":["count","items"],"title":"NewsChannelCatalogResponse","description":"Free catalog of available source channels."},"NewsPaymentResponse":{"properties":{"scheme":{"type":"string","title":"Scheme"},"network":{"type":"string","title":"Network"},"currency":{"type":"string","title":"Currency"},"pay_to":{"type":"string","title":"Pay To"},"asset":{"type":"string","title":"Asset"},"amount":{"type":"string","title":"Amount"},"price":{"type":"string","title":"Price"}},"type":"object","required":["scheme","network","currency","pay_to","asset","amount","price"],"title":"NewsPaymentResponse","description":"Payment details echoed after a successful x402-verified response."},"NewsQuoteAvailability":{"properties":{"available_count":{"type":"integer","title":"Available Count"},"billable_count":{"type":"integer","title":"Billable Count"},"is_free":{"type":"boolean","title":"Is Free"}},"type":"object","required":["available_count","billable_count","is_free"],"title":"NewsQuoteAvailability","description":"Availability metadata used to explain what will be billed."},"NewsQuoteBreakdown":{"properties":{"base_price":{"type":"string","title":"Base Price"},"final_price":{"type":"string","title":"Final Price"},"count_multiplier":{"type":"string","title":"Count Multiplier"},"freshness_multiplier":{"type":"string","title":"Freshness Multiplier"},"freshness_tier":{"type":"string","title":"Freshness Tier"},"billing_strategy":{"type":"string","title":"Billing Strategy"}},"type":"object","required":["base_price","final_price","count_multiplier","freshness_multiplier","freshness_tier","billing_strategy"],"title":"NewsQuoteBreakdown","description":"Availability-aware x402 pricing breakdown for a news query preview."},"NewsQuoteResponse":{"properties":{"price":{"type":"string","title":"Price"},"currency":{"type":"string","title":"Currency"},"network":{"type":"string","title":"Network"},"pay_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pay To"},"pricing_model":{"type":"string","title":"Pricing Model"},"pricing_dimensions":{"items":{"type":"string"},"type":"array","title":"Pricing Dimensions"},"quote_id":{"type":"string","title":"Quote Id"},"quote_expires_at":{"type":"string","format":"date-time","title":"Quote Expires At"},"pricing_hash":{"type":"string","title":"Pricing Hash"},"limit":{"type":"integer","title":"Limit"},"channel":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Channel"},"since":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Since"},"valid_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Valid Until"},"license":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"License"},"availability":{"$ref":"#/components/schemas/NewsQuoteAvailability"},"breakdown":{"$ref":"#/components/schemas/NewsQuoteBreakdown"}},"type":"object","required":["price","currency","network","pricing_model","pricing_dimensions","quote_id","quote_expires_at","pricing_hash","limit","availability","breakdown"],"title":"NewsQuoteResponse","description":"Preview response for the free `/v1/news/quote` endpoint."},"NewsResponse":{"properties":{"count":{"type":"integer","title":"Count"},"items":{"items":{"$ref":"#/components/schemas/MessageLogResponse"},"type":"array","title":"Items"},"meta":{"$ref":"#/components/schemas/NewsResponseMeta"},"window":{"$ref":"#/components/schemas/NewsBatchWindow"},"payment":{"anyOf":[{"$ref":"#/components/schemas/NewsPaymentResponse"},{"type":"null"}]}},"type":"object","required":["count","items","meta","window"],"title":"NewsResponse","description":"Batch response for the paid `/v1/news` endpoint."},"NewsResponseMeta":{"properties":{"channel":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Channel"},"since":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Since"},"limit":{"type":"integer","title":"Limit"},"available_count":{"type":"integer","title":"Available Count"},"billable_count":{"type":"integer","title":"Billable Count"},"is_free":{"type":"boolean","title":"Is Free"},"delivery_mode":{"type":"string","title":"Delivery Mode"},"sort":{"type":"string","title":"Sort","default":"created_at_desc"},"has_more":{"type":"boolean","title":"Has More","default":false},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"quote_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote Id"},"pricing_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pricing Hash"},"content_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Hash"},"valid_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Valid Until"},"license":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"License"}},"type":"object","required":["limit","available_count","billable_count","is_free","delivery_mode"],"title":"NewsResponseMeta","description":"Query and billing metadata for a paid or free-empty batch response."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}