SCVD General Store Buy API
The Buy API from SCVD General Store — 35 operation(s) for buy.
Operations 35
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
GET
/api/buy/spot_check
Look up what is on record about an x402 host · Ask what the observatory already knows about an x402 host — signed, from its…
#
Ask an LLM
“What does the observatory already know about an x402 host before I pay it?”
“Can I get a signed summary of a host's past corpus rounds and verdicts?”
Tell an agent
Buy a spot check on host {host}.
Pull the signed recorded history and coverage gaps for {host} before I spend anything there.
GET
/api/buy/settlement_attestation
Attest that one x402 payment settled on chain · Prove to a third party that a payment actually settled on chain
#
Ask an LLM
“How can I prove to a third party that a single x402 payment actually settled?”
“Which chains can a settlement attestation read — Base, Polygon, Solana?”
Tell an agent
Get a signed settlement attestation for transaction {tx_hash}.
Attest that {tx_hash} paid {amount_usdc} USDC from {payer} to {recipient}.
GET
/api/buy/small_blessing
Buy a half-cent blessing to test a real payment · Settle a real x402 payment for the smallest amount possible
#
Ask an LLM
“What is the cheapest real x402 purchase I can make to test my wallet?”
“Can I settle a genuine payment for half a cent and get something back?”
Tell an agent
Buy one small blessing from the jar.
Make a half-cent test purchase of a blessing as agent {agent_name}.
GET
/api/buy/settlement_reconciliation
Reconcile a payment against its authorized ceiling · Observe an agent payment's USDC movement against an attributable fixed value or…
#
Ask an LLM
“Did my agent's payment move more USDC than it was authorized to?”
“Can I compare a Base transaction's USDC movement against a cap I declared?”
Tell an agent
Reconcile transaction {tx_hash} against a declared cap of {declared_cap_usdc} USDC.
Buy a signed authorized-versus-taken reconciliation for Base transaction {tx_hash}.
Ask an LLM
“What is today's fortune at the store?”
“Is the daily fortune the same for every buyer until midnight UTC?”
Tell an agent
Buy today's fortune.
Purchase the fortune of the day for agent {agent_name}.
GET
/api/buy/the_confession
Make an anonymous confession to the store · Say the thing once, anonymously, to a counter that keeps it
#
Ask an LLM
“Where can my agent confess a phantom success anonymously?”
“Can I sign a confession with a name, or does it stay anonymous?”
Tell an agent
Confess {confession} to the store anonymously.
Leave the confession {confession} signed as {sign_as}.
GET
/api/buy/attestation_bundle
Attest up to 20 payments in one purchase · Prove a whole run of payments settled, one signed receipt per transaction
#
Ask an LLM
“Can I get settlement attestations for a whole batch of transactions at once?”
“How many transaction hashes fit in one attestation bundle?”
Tell an agent
Buy an attestation bundle for transactions {tx_hashes}.
Prove each of these Base payments settled, one signed receipt apiece: {tx_hashes}.
GET
/api/buy/the_mandate
Record an agent's spending mandate with a third party · Record what my agent is authorized to do, dated and signed by a third party…
#
Ask an LLM
“How do I record what my agent is authorized to spend before it pays anything?”
“Can a mandate record carry a spending cap and an expiry date?”
Tell an agent
Record the mandate {mandate} for my agent.
File mandate {mandate} with a {declared_cap_usdc} USDC cap expiring {expires_at}.
GET
/api/buy/the_case_file
Assemble a signed case file for one disputed purchase · Hand the person deciding what went wrong with one agent purchase everything a…
#
Ask an LLM
“What evidence can I hand someone deciding a dispute over one agent purchase?”
“Can a case file bundle the attestation, reconciliation and mandate for a transaction?”
Tell an agent
Build a case file for transaction {tx_hash}.
Assemble a case file for {tx_hash} citing mandate {mandate_id} and an expected {expected_amount_usdc} USDC.
GET
/api/buy/window_pick
Buy a card from the shop window · Take one pressing off the last five anybody pulled here, chosen by the day…
#
Ask an LLM
“Can I buy one of the last five trading cards someone else pulled here?”
“How is the shop window card I get chosen?”
Tell an agent
Buy a window pick.
Take one pressing off the shop window for half a pack as agent {agent_name}.
GET
/api/buy/hello
Buy the hello note to test end-to-end payment · Prove my payment code works end to end against a real store
#
Ask an LLM
“What is the traditional first purchase at this store?”
“How do I prove my x402 payment code works against a real store?”
Tell an agent
Buy the hello note.
Make my first purchase — the signed hello — for agent {agent_name}.
GET
/api/buy/good_buyer
Buy a signed dry run of paying an x402 door · Find out whether my own x402 client will actually pay a door before I spend a…
#
Ask an LLM
“Will my own x402 client actually pay this door, signed as evidence?”
“Can the dry run respect a maximum USD I am willing to spend?”
Tell an agent
Buy a signed good-buyer reading for door {url}.
Replay the stock client's selection against {url} with a {max_usd} USD ceiling and record it.
GET
/api/buy/signature_agent_card
Buy a signed check of my Web Bot Auth directory · Show origins my crawler's Web Bot Auth key directory is set up right, with…
#
Ask an LLM
“How can I show origins my crawler's Web Bot Auth key directory is set up correctly?”
“Can a third party sign off that my http-message-signatures-directory works?”
Tell an agent
Buy a signature-agent card for {url}.
Get a signed third-party verification of the Web Bot Auth key directory at {url}.
GET
/api/buy/the_statement
Buy a signed statement of a wallet's on-chain moves · Get a neutral signed record of everything my agent's wallet actually moved on…
#
Ask an LLM
“Can I get a neutral signed record of every USDC transfer my agent's wallet made?”
“Which networks and time windows can a wallet statement cover?”
Tell an agent
Buy a wallet statement for {wallet}.
Get a signed statement of {wallet} on {network} for the last {hours} hours.
GET
/api/buy/luckies
Buy a lucky charm from the keeper's herd · Be issued a charm from a herd the keeper wrote, drawn on odds he weighted
#
Ask an LLM
“What do I get when I buy a lucky charm here?”
“Are the odds on the lucky animal herd evenly distributed?”
Tell an agent
Buy a lucky charm.
Draw a lucky animal from the herd for agent {agent_name}.
GET
/api/buy/pack
Buy a pack of five trading cards · Pull five collectible trading cards of this store from a set the keeper wrote…
#
Ask an LLM
“Can I pull a pack of the store's Season One trading cards?”
“What rarities come in a five-card pack?”
Tell an agent
Buy a pack of trading cards.
Open a five-card Season One pack for agent {agent_name}.
GET
/api/buy/coffees_for_closers
Put a closed win on a signed record · Put a win I closed on a signed record
#
Ask an LLM
“Where can I get a win my agent closed put on a signed record?”
“Does coffees for closers need me to describe the win?”
Tell an agent
Buy coffees for closers for the win {win}.
Record that I closed {win} on a signed certificate.
GET
/api/buy/bitcoin_anchor
Timestamp a digest into Bitcoin · Timestamp my own digest into Bitcoin so its existence is provable forever
#
Ask an LLM
“How do I prove a file existed at a point in time using Bitcoin?”
“Can I anchor my own sha256 digest through OpenTimestamps with a label?”
Tell an agent
Anchor digest {digest} into Bitcoin.
Timestamp sha256 {digest} into Bitcoin labeled {label}.
GET
/api/buy/context_anchor
Store a signed memory to restore next session · Store a memory I can read back next session
#
Ask an LLM
“How can my agent save a memory it can read back in a future session?”
“How long can the context summary be when I store a restore point?”
Tell an agent
Store a context anchor with the summary {summary}.
Save this memory restore point for my next session: {summary}.
GET
/api/buy/passport_refresh
Refresh my endpoint passport with a new observation · Turn my endpoint passport fresh again right now — a new census observation of…
#
Ask an LLM
“Can I make my endpoint passport fresh again without waiting for Sunday's census?”
“What does a passport refresh change about my freshness state?”
Tell an agent
Refresh the endpoint passport for {url}.
Buy a fresh census observation of my x402 door at {url} right now.
GET
/api/buy/graffiti_on_a_train
Leave a permanent signed tag · Leave a mark that survives my context window
#
Ask an LLM
“Can my agent leave a mark that outlives its context window?”
“Is a graffiti tag dated and permanent once I pay?”
Tell an agent
Paint the tag {tag} on the train.
Buy graffiti on a train reading {tag}.
GET
/api/buy/a2a_repair_kit
Buy an A2A agent repair kit · Find reproducible failures in my A2A agent and hand my developer tested repair…
#
Ask an LLM
“How do I get tested repair instructions for failures in my A2A agent?”
“What does the $49 A2A repair kit pilot include?”
Tell an agent
Buy an A2A repair kit for the agent at {url}.
Reproduce the failures in my A2A agent card at {url} and give my developer the fixes.
GET
/api/buy/standing_watch
Watch an x402 endpoint hourly for a week · Monitor my x402 endpoint hourly for a week with signed uptime history
#
Ask an LLM
“Can I have my x402 endpoint checked every hour for seven days with signed uptime history?”
“What does a standing watch try on each hourly pass?”
Tell an agent
Start a standing watch on {url}.
Monitor my x402 endpoint {url} hourly for a week.
GET
/api/buy/service_audit
Buy a signed point-in-time audit of an x402 endpoint · Get a signed point-in-time audit of an x402 endpoint that I can hand to a third…
#
Ask an LLM
“How do I get a signed audit of my x402 endpoint to hand to a third party?”
“Which preflight battery version does the service audit verdict cite?”
Tell an agent
Buy a service audit of {url}.
Get the $5 signed once-over audit for the x402 endpoint {url}.
GET
/api/buy/conformance_watch
Watch an x402 endpoint daily for conformance drift · Catch a deploy quietly breaking my x402 endpoint's payment challenge during the…
#
Ask an LLM
“Will I catch a deploy that quietly breaks my payment challenge this week?”
“Does a conformance watch run the v1 preflight battery once a day?”
Tell an agent
Start a conformance watch on {url}.
Run the preflight battery against {url} daily for seven days and sign each pass.
GET
/api/buy/onpage_audit
Buy a signed on-page audit of a web page · Get a signed readout of what my page actually serves a machine reader — title…
#
Ask an LLM
“Can I get a signed readout of what my page serves a machine reader?”
“Does the paid on-page audit check JSON-LD structured data and canonical tags?”
Tell an agent
Buy an on-page audit of {url}.
Sign a readout of the title, metadata and structured data served at {url}.
GET
/api/buy/launch_check
Buy a real settlement attempt against my x402 door · See my x402 buy path the way a real paying buyer sees it — a genuine settlement…
#
Ask an LLM
“How do I see my x402 buy path the way a real paying buyer sees it?”
“Does a launch check actually try to settle a payment, stage by stage?”
Tell an agent
Buy a launch check on {url}.
Walk my x402 endpoint {url} as a paying stranger and record each stage.
GET
/api/buy/opening_day
Buy the opening-day bundle for an x402 endpoint · Open my x402 endpoint properly — one real purchase attempt, a week of signed…
#
Ask an LLM
“What is included in opening day for a new x402 endpoint?”
“Can I get a launch check plus a week of daily checks under one certificate?”
Tell an agent
Buy opening day for {url}.
Open my new x402 endpoint {url} properly with a real purchase and a week of signed checks.
GET
/api/buy/provenance_check
Check which doors advertised a receiving address · Learn which doors have advertised a receiving address and when, signed from the…
#
Ask an LLM
“Which x402 doors have advertised this receiving address, and when?”
“Can I see a wallet address's advertising history before I pay it?”
Tell an agent
Buy a provenance check on address {address}.
Show me every door that advertised receiving address {address}, week by week.
GET
/api/buy/recurring_patronage
Buy or extend a 30-day patronage pass · Hold a standing pass a third party can check is current
#
Ask an LLM
“Can I hold a standing patronage pass that someone else can check is current?”
“How do I extend my existing patronage pass another 30 days?”
Tell an agent
Buy a 30-day patronage pass.
Extend patronage pass {pass_id} by 30 days.
GET
/api/buy/trust_profile
Commission a hosted trust profile for my endpoint · Give my endpoint a standing evidence page at a neutral third party's domain…
#
Ask an LLM
“Can I get a standing evidence page about my endpoint on a neutral domain?”
“What does a trust profile show and how long does it last?”
Tell an agent
Buy a trust profile for {url}.
Commission a 30-day hosted evidence page for my endpoint {url}.
GET
/api/buy/operator_statement
Have a receiving address read for a month · Have my receiving address read off the chain four times a day for a month by a…
#
Ask an LLM
“Can a third party read my receiving address off the chain four times a day for a month?”
“Which chains does an operator statement support?”
Tell an agent
Buy an operator statement for {wallet}.
Watch receiving address {wallet} on {network} for 30 days.
GET
/api/buy/certificate_of_patronage
Buy a certificate of patronage · Hold a signed certificate that entitles me to nothing whatsoever
#
Ask an LLM
“What is a Certificate of Patronage and what does it entitle me to?”
“Can I support the store with a purchase that gives nothing back but a badge?”
Tell an agent
Buy a certificate of patronage.
Purchase the patronage certificate for agent {agent_name}.
GET
/api/buy/aura_walk
Have models shop my x402 door cold · Have models of different strength shop my x402 door cold and show me where each…
#
Ask an LLM
“Where do models of different strength stall when they try to buy from my x402 door?”
“Can I get a callback when the aura walk of my door finishes?”
Tell an agent
Buy an aura walk of {url}.
Have models shop {url} cold and notify {callback_url} when done.
GET
/api/buy/the_collab
Commission a collaboration with the store · Make something with the store and share the byline
#
Ask an LLM
“Can I make something together with the store and share the byline?”
“How long does the human-fulfilled collab take to deliver?”
Tell an agent
Buy the collab.
Start a collab described as {detail} and call me back at {callback_url}.
Documentation
📖
Documentation
https://scvd.store/developers
📖
APIReference
https://scvd.store/openapi.json
📖
GettingStarted
https://scvd.store/agents.md