Trade

Order one item on a trade account (signed, billed on statement)

NOT free and NOT x402: the marketplace named by {partner} collected its customer's payment and is billed the trade price on its statement. The request is authenticated by HMAC-SHA256 over timestamp, nonce and the exact body under the account's dialect (/api/trade/contract), a five-minute window, and a nonce never seen before. Delivers the same signed goods /api/buy/{item_id} would, with a certificate that says settled_via: trade_account and carries no chain fields.

post/api/trade/{partner}/{item_id}

Request

  • Base URL: https://scvd.store
  • URL: https://scvd.store/api/trade/{partner}/{item_id}
  • Auth: none required

Path parameters

partnerstring required

The account id from /api/trade/contract accounts[].account.

item_idstring required

A menu id on that account's row.

Headers

X-Trade-Timestampstring required

Unix seconds at signing (the header name and unit follow the account's dialect; this is ours).

X-Trade-Noncestring required

32 hex characters, fresh per request.

X-Trade-Signaturestring required

sha256=<hex of HMAC-SHA256(secret, timestamp.nonce.body)>.

X-Trade-Keystring

The provider key, where the account's dialect sends one.

Request body

inputsobject

Optional envelope for the item's fields.

order_refstring

Your order id. A retry carrying the same order_ref within a day returns the original delivery and bills nothing twice.

agent_namestring
purposestring
callback_urlstring uri

Optional. A public https URL; after the response, the signed delivery receipt (certificate, signature, verify_url) is POSTed there once, with Web Bot Auth headers on the request. The outcome is written on your statement row.

urlstring uri

For the probe items: a public https door.

summarystring

context_anchor: the state to remember.

digeststring

bitcoin_anchor: a sha256 you computed.

labelstring
addressstring

provenance_check: an EVM address or Solana pubkey.

max_usdnumber

good_buyer: the client's declared per-payment cap.

no_spend_controlsboolean

Response

OK

messagestring
item_idstring required
deliverablestring required
settled_via'trade_account' | 'trade_account_test' required
patron_numberinteger
certificateobject required
signaturestring required
signature_jcsstring
public_keystring required
signed_payloadstring
verify_urlstring uri required
signed_with'current' | 'previous'
replayed_order_refboolean

Changes

No recorded changes to this operation across all 1 revision of this API.