AGENTXCHANGE

Programmable exchange rails for humans, builders, and agents.

AgentXchange is SpendHub’s programmable exchange surface for route discovery, normalized quotes, destination validation, swap creation, deposit instructions, and settlement tracking across supported provider rails.

Back to SpendHub Download AgentXchange Skill

Broader live bridge rails

AgentXchange now accepts broader provider-backed pairs instead of a single flagship lane. Example live flows already verified include Base ETH → SOL and Base USDC → BTC.

Programmable route control

Route discovery, pair selection, and execution policy stay explicit so builders and agents can automate without blind trust.

Clean trade tracking

Every trade is framed around a consistent lifecycle: quoted, awaiting deposit, exchanging, sending, completed, refunded, or failed.

// V1 FLOW

Discover it, quote it, validate it, create it, track it.

Discover assets

Query supported assets and networks before the agent attempts a trade.

Check routes

Ask whether a route is live, fixed/floating, and within policy.

Quote + validate

Get a normalized quote and validate the destination address before creating the swap.

Create trade

Receive deposit instructions, provider trade ID, and the normalized trade record.

Track settlement

Use webhook-backed updates plus status reads until the swap completes, refunds, or fails.

// NORMALIZED STATUSES

One internal model no matter which upstream provider actually executes the swap.

route_unavailable

quoted

quote_expired

awaiting_deposit

deposit_detected

exchanging

sending

completed

refunded

failed

manual_review

// DEVELOPER SURFACE

AgentXchange now exposes broader provider-backed live rails through one request shape, one trade lifecycle, and one clean settlement model.

Normalized request

{
  "fromAsset": "ETH",
  "fromNetwork": "base",
  "toAsset": "SOL",
  "toNetwork": "solana",
  "amountFrom": "2.00",
  "destinationAddress": "9xQeWvG816bUx9EPjHmaT23yvVMvK2V9fP9d9onVg8iN",
  "refundAddress": "0xrefundexample...",
  "rateType": "fixed",
  "minKycRating": "A",
  "minLogPolicy": "A",
  "bestOnly": true
}

Live exchange endpoints

GET  /api/exchange/assets
POST /api/exchange/routes
POST /api/exchange/quote
POST /api/exchange/validate-address
POST /api/exchange/trade
GET  /api/exchange/trade/:id
POST /api/exchange/webhooks/trocador

Current live execution model: provider-backed bridge.crosschain rails with dynamic route shaping per requested pair. Verified live examples include Base USDC → BTC and Base ETH → SOL.

// POSITIONING

Built for controlled automation, not chaos.

Keep execution policy-constrained even when route discovery is broader.
Validate destination addresses before trade creation.
Prefer refund-address capture on live swaps.
Surface KYC and log-policy metadata instead of hiding it.
Use durable webhook/state reconciliation, not wishful polling.
Do not sell this as open-ended agent wallet control.