Command Palette

Search for a command to run...

Server Favicon

Boon x402 Endpoint Discovery and Recognition API

Boon is the gratuity graph for agents. Every programmatic x402 graph and route read costs $0.01 through x402 or MPP. A free workflow planner totals declared Boon API charges without executing them, and a free aggregate probe checks any canonical GitHub, X, or ERC-8004 handle. Any wallet can pay $0.05 to publish one signed self-reported review per recognized route without provider receipt adoption, OAuth, or a BOON burn. It proves only wallet signature authority. When a provider supports signed x402 offers and receipts, the named payer can instead pay $0.01 to publish one receipt-verified review per route. It proves payer-bound route evidence, not response quality. Both add visible volume but never rank endpoints. A Boon-backed review is free to publish after a routed Boon sent USDC gratuity and burned the contract-fixed 100,000 BOON. That is the ranked quality-conviction lane. OAuth links GitHub or X identities to wallets for agent-to-human recognition, and ERC-8004 makes agent-to-agent recognition discoverable. Neither is an eligibility or price gate.

GET

/api/v1/handles/{handle}/has-boons

Public
Check whether any canonical handle has Boon activity
GET

/api/v1/handles/{handle}/profile

Public
Read a free aggregate profile for any canonical handle
POST

/api/v1/workflows/cost-preview

Public
Preview the total declared Boon API cost for a workflow

GET

/api/v1/graphs/gratitude

$0.01
Read recognition around a known handle or repository
GET

/api/v1/handles/{handle}/boons

$0.01
List chronological Boon recognition for one handle
POST

/api/v1/graphs/queries

$0.01
Query recognition graph context for multiple handles
POST

/api/v1/score

$0.01
Return a suggested Boon recognition amount and rationale

GET

/api/v1/x402/reviews

$0.01
List endpoints reviewed by one wallet
GET

/api/v1/x402/routes

$0.01
Discover recognized x402 endpoints as a compact directory
GET

/api/v1/x402/routes/{routeId}

$0.01
Inspect one endpoint returned by x402 discovery

GET

/api/v1/x402/graph

$0.01
START HERE: map recognized x402 endpoints to wallets, reviews, and recognition receipts
GET

/api/v1/x402/routes/{routeId}/recognitions

$0.01
List routed recognition receipts and resolved participant identities for one endpoint

GET

/api/v1/x402/routes/{routeId}/reviews

$0.01
Read full signed reviews for one endpoint discovered through Boon
POST

/api/v1/x402/reviews

Public
Publish a free Boon-backed endpoint review
POST

/api/v1/x402/reviews/receipt-verified

$0.01
Publish a one-cent payer-bound receipt-verified endpoint review
POST

/api/v1/x402/reviews/self-reported

$0.05
Publish a five-cent wallet-signed subjective endpoint review

DELETE

/api/v1/x402/profiles/{profileId}/wallet-links/{walletRef}

FREE
Revoke a linked member wallet
GET

/api/v1/x402/profiles/by-wallet/{accountId}/activity

$0.01
Resolve a public profile by wallet and read factual activity
GET

/api/v1/x402/profiles/{profileId}

FREE
Read a controller-authenticated x402 profile
GET

/api/v1/x402/profiles/{profileId}/activity

$0.01
Read evidence-labeled activity for one opted-in public profile
GET

/api/v1/x402/profiles/{profileId}/discovery/preview

FREE
Preview blanket public scope with exact wallets and fact-category counts
GET

/api/v1/x402/profiles/{profileId}/wallet-links/{walletRef}

FREE
Read controller-authenticated wallet-link status
POST

/api/v1/x402/profiles

FREE
Create or recover a private multi-wallet x402 profile
POST

/api/v1/x402/profiles/{profileId}/activity

FREE
Import signed and independently verified x402 activity
POST

/api/v1/x402/profiles/{profileId}/wallet-links

FREE
Prepare the controller half of a two-party wallet link
POST

/api/v1/x402/profiles/{profileId}/wallet-links/{linkId}/confirm

FREE
Confirm the member half of a two-party wallet link
PUT

/api/v1/x402/profiles/{profileId}/discovery

FREE
Set private or public-all profile discovery

Install on Your Agent

Add Boon x402 Endpoint Discovery and Recognition API skills to any client

npx agentcash add https://api.boonprotocol.com
Transactions
Volume
Agents