API

Quote, build, submit.

Quotes travel as an HMAC-signed payload. At submit the service rebuilds the inner transaction and compares XDR byte for byte. Prefix every path with /testnet or /mainnet. Spec: openapi.yaml.

• Site https://reserve.cavos.xyz
• Testnet https://reserve.cavos.xyz/testnet
• Mainnet https://reserve.cavos.xyz/mainnet

POST /{network}/v1/quote

{ source, fee_token, ops[] }. Operations: create_account, payment, change_trust, claim_balance. Returns a sealed quote and the price in stroops. To activate an address that holds nothing, pay it a claimable balance and send those three operations together. See Activate an account with a token.

POST /{network}/v1/build

{ quote } → unsigned inner transaction XDR. Verify it locally against the request you made before anyone signs.

POST /{network}/v1/submit

{ quote, signed_xdr } → hash. The service fee-bumps and submits. A mismatch is refused.

GET /{network}/v1/tokens

Assets this deployment accepts, with issuer and home domain.

GET /{network}/v1/status/{hash}

Horizon’s view of a submitted transaction.

Optional: keys

A key is identity, never authorisation. Unkeyed callers are served from a smaller budget. Same endpoints either way.

POST /{network}/v1/challenge  { address }     → a transaction to sign
POST /{network}/v1/keys       { signed_xdr }  → cav_…

The challenge is sequence number zero, so the network can never accept it. Signing again returns the same key. Raise the limit from the product page.