{"uid":"cap_FHWJlJGOQ649MtjSaLtZk","slug":"forgemesh-x402-funnel-theory-89be49fa","name":"ForgeMesh x402 Funnel Theory","description":"The funnel logic behind ForgeMesh's x402 pricing and discovery design, as 10 structured tenets: why discovery stays free, why the 402 challenge itself is a probe, why failed upstreams never charge, and why prices ladder from taste-test to premium. Written for agents and builders evaluating or designing paid API funnels.","url":"https://x402.forgemesh.io/x402-funnel-theory","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":[],"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"title":"ForgeMesh theory of agent-commerce discovery","tenets":[{"id":"rich-free-surfaces","tenet":"Free discovery surfaces stay rich.","detail":"llms.txt, openapi.json, and .well-known/x402.json expose every route, price, and schema at no cost, so crawlers and humans can index a service fully without ever paying."}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_e2J4cUSCRhFsNsXtfPes2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the 10 structured tenets behind ForgeMesh's x402 pricing and API discovery design philosophy, explaining why discovery is free, how 402 challenges act as probes, and how prices ladder from taste-test to premium.","exampleAgentPrompt":"Can you pull up ForgeMesh's x402 funnel theory doc — I want to understand why discovery is free, how the 402 challenge acts as a probe, and how pricing ladders from taste-test to premium across their 10 design tenets?","exampleUseCases":null,"resultDescription":"A structured document containing 10 tenets that explain ForgeMesh's x402 funnel design: why discovery endpoints are free, how the HTTP 402 challenge itself serves as a discovery probe, why failed upstream calls are never billed, and how price tiers are structured from low-cost taste-tests up to premium calls — intended for agents and builders evaluating or designing paid API funnels.","failureModes":["Empty or malformed request body may result in a 400 error","Service unavailability returns a 5xx error","Incorrect Content-Type header may cause request rejection","Payment failure returns HTTP 402 with payment challenge before content is delivered"],"whenToPreferThis":"Use this endpoint when you need to understand the design philosophy and monetization principles behind the x402 protocol as implemented by ForgeMesh — especially when evaluating whether to build on or integrate with x402-based APIs, or when you want to understand why pricing and discovery behave the way they do in this ecosystem.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:56:03.864Z","isFirstParty":false}