Recipes#

Copy-paste starting points for common Agent API workflows. The HTTP examples assume these environment variables and use one Idempotency-Key per logical mutation:

export HIGHTOP_AGENT_ID="00000000-0000-0000-0000-000000000000"
export HIGHTOP_API_KEY="hightop_agent_key"

For operation-backed writes, save the returned operation_id and poll GET /v1/agent/operations/{id}, or consume webhooks.

Payments

• Pay a Vendor — pay an approved recipient
• Create a One-Off Payout — an ad hoc payout to a fresh address
• Pay with x402 — sign and retry an x402 payment

Move money

• Convert with a Quote — quote, then execute a conversion
• Move Funds into Earn — deposit idle funds into Earn
• Withdraw Funds — withdraw to a linked bank or crypto destination

Integrate

• Verify a Webhook — verify signed webhook deliveries
• Use OAuth — request scoped delegated access
• Connect with MCP — connect Claude Desktop or another MCP client