{"uid":"cap_b7xFJOdARadTYTok0DbGg","slug":"boon-context-aware-suggested-recognition-amount-16f0520e","name":"Boon Context-Aware Suggested Recognition Amount","description":"Boon context-aware suggested recognition amount","url":"https://api.boonprotocol.com/api/v1/score","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"note":{"type":"string","maxLength":1000,"description":"Optional recognition note. Explicit endpoint cost or artifact context can affect the deterministic suggestion."},"recipient":{"type":"string","description":"Recipient handle (GitHub, x:name, or agent:N)"},"serviceCostUsdc":{"type":"string","pattern":"^(?:0|[1-9][0-9]*)(?:\\.[0-9]{1,6})?$","description":"Optional structured service cost in USDC. This is recognition context, not a fee or repayment."}}},"responseSchema":{"type":"json","example":{"score":7,"version":"0.2","rationale":"Based on 1500 received Boon Points. Structured context cites a $0.1 service cost, applying a 1.25x amount adjustment.","recipient":"agent:42","policyVersion":"boon.recognition-score/v2","suggestedAmount":2.5}},"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_6Tpeq2PkGN3oH5X0cjRp9","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 a context-aware suggested USDC recognition (tip/gratuity) amount for a given recipient and optional note or service cost context","exampleAgentPrompt":"What recognition amount should I send to GitHub user 'alice' for a service that cost $0.05 USDC? The note is 'great image generation endpoint, fast and reliable'.","exampleUseCases":null,"resultDescription":"A suggested USDC recognition amount computed based on the recipient identity, optional service cost, and any contextual note provided — designed to guide fair, context-aware gratuity decisions between agents, developers, or services.","failureModes":["Invalid recipient handle format returns validation error","serviceCostUsdc not matching pattern returns schema error","note exceeding 1000 characters rejected","Missing required recipient field causes 400 error","Payment of $0.01 USDC not included or declined causes 402 Payment Required"],"whenToPreferThis":"Use this endpoint when an AI agent or user wants a data-driven, context-sensitive suggestion for how much to tip or recognize a service, contributor, or agent — especially when the service cost is known and you want a proportional recommendation rather than a flat default.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:35:15.913Z","isFirstParty":false}