{"uid":"cap_aD-ZHsgdKX6v5j8ewF2xh","slug":"boon-protocol-x402-route-recognition-history-59ba4080","name":"Boon Protocol — x402 Route Recognition History","description":"Boon is the gratuity graph for agents. Discover recognized x402 endpoints for free, compare signed reviews with USDC recognition and $BOON burned, then pay one cent through x402 or MPP only for full review history.","url":"https://api.boonprotocol.com/api/v1/x402/routes/%7BrouteId%7D/recognitions","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["routeId"],"properties":{"routeId":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","description":"The routed x402 endpoint ID."}}},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","default":25,"maximum":100,"minimum":1},"offset":{"type":"integer","default":0,"maximum":1000,"minimum":0}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"query":{"limit":25,"offset":0,"routeId":"0x9569f7ef2e344da57aa497dafe4509499f133340d1e0ab0d3e93f6e7c057bb0e"},"version":"1","routedBoons":[{"tipper":"0x0000000000000000000000000000000000000002","routeId":"0x9569f7ef2e344da57aa497dafe4509499f133340d1e0ab0d3e93f6e7c057bb0e","boonBurned":"100000000000000000000000","networkGratuityUsdc":"0","endpointGratuityUsdc":"100000"}]}},"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_Md3f2Dd3knRjBI5t7U7Tw","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":"Retrieves the paginated list of onchain recognitions (tips) made to a specific x402 route, including USDC gratuity and $BOON burned amounts.","exampleAgentPrompt":"Pull up the full recognition history for x402 route 0x9569f7ef2e344da57aa497dafe4509499f133340d1e0ab0d3e93f6e7c057bb0e on Boon — show me all the tippers, how much USDC gratuity was sent, and how much $BOON was burned, up to 50 results.","exampleUseCases":[{"title":"Audit tips received by an API","prompt":"Show me every wallet that has recognized x402 route 0x9569f7ef2e344da57aa497dafe4509499f133340d1e0ab0d3e93f6e7c057bb0e on Boon and how much USDC gratuity each one sent — give me the first 25 results."},{"title":"Track $BOON burn for a route","prompt":"For Boon route 0x9569f7ef2e344da57aa497dafe4509499f133340d1e0ab0d3e93f6e7c057bb0e, how much $BOON has been burned across all recognitions? Pull up to 100 records so I can total it up."},{"title":"Compare recognition depth across endpoints","prompt":"Get me the recognition history for x402 route 0x9569f7ef2e344da57aa497dafe4509499f133340d1e0ab0d3e93f6e7c057bb0e on Boon, starting at offset 25 with a limit of 25, so I can compare the second page of tippers against the first."}],"resultDescription":"Returns a paginated JSON object containing the routeId queried, pagination parameters (limit, offset), and an array of routedBoons — each entry includes the tipper wallet address, routeId, boonBurned (in wei-scale units), networkGratuityUsdc, and endpointGratuityUsdc (in micro-USDC). Structured as version-tagged JSON.","failureModes":["Invalid routeId format (not 0x + 64 hex chars) returns a validation error","RouteId not found in the graph returns an empty routedBoons array","offset exceeds maximum of 1000 — returns error","limit exceeds 100 — returns validation error","Payment not completed via x402 or MPP results in 402 Payment Required response","Network or upstream blockchain indexing delay may cause stale data"],"whenToPreferThis":"Use this endpoint when you need the full paginated onchain recognition history for a specific x402 route — including who tipped, how much USDC was given, and how much $BOON was burned. Prefer this over the free route-discovery endpoint when you need granular per-tipper detail rather than aggregate summaries. It costs $0.01 USDC per call via x402 or MPP. Choose it over general blockchain explorers when you need Boon-specific gratuity graph data in structured JSON.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:30:02.607Z","isFirstParty":false}