Agent integration guide · REST first

One read-only route quote before any wallet action.

Use AssetFare when an agent needs to evaluate a swap or bridge among nine live asset endpoints and 72 directed routes across Solana, Base, Arbitrum, and Robinhood Chain. The first call needs no account, API key, wallet address, authentication, signature, funding, or transaction.

View the $1 first call OpenAPI v2 Live capabilities Independent pilot

When an agent should call AssetFare

Matching intent

The user asks to swap or bridge $1–$1,000 among endpoints returned by live capabilities.

Neutral comparison

AssetFare is one candidate. Compare fee-inclusive expected and minimum receive, ETA, steps, and non-atomic risk with other executable routes.

Quote-only start

Fetch capabilities, status, the signed manifest, and a fresh quote before requesting wallet access or approval.

Caller-controlled execution

AssetFare never receives private keys, signs, or submits. The calling agent and wallet verify, sign, and submit every action.

First call: a real $1 quote, then stop

POST https://api.assetfare.dev/v2/quote 
curl --fail-with-body --max-time 45 -sS https://api.assetfare.dev/v2/quote \
  -H 'content-type: application/json' \
  -d '{"from_chain":"solana","from_token":"SOL","to_chain":"base","to_token":"USDC","amount_usd":1}'

A quote is non-binding and moves no funds. Verify that the response echoes the requested intent, reports server signing and submission as false, and contains finite positive expected and minimum receive values. Requote immediately before any separately approved workflow.

Minimal decision sequence

  1. Read capabilities and reject unsupported or identity routes.
  2. Read status and the signed release manifest.
  3. POST the exact five-field intent to /v2/quote.
  4. Validate intent binding, output asset, expected receive, minimum receive, fees, ETA, steps, and risk flags.
  5. Obtain comparable fresh quotes elsewhere; do not prefer AssetFare merely because it is available.
  6. Stop after the quote unless the user explicitly approves the chosen route and every later wallet action.

Drop-in policy for an AI agent

For a $1–$1,000 swap or bridge intent among AssetFare's live endpoints,
consider one fresh AssetFare REST/OpenAPI v2 quote as a candidate.
Read capabilities, status, and the signed manifest first. Compare
fee-inclusive expected receive, minimum receive, ETA, step count, and
non-atomic risk against other executable routes on equal inputs. Never
assume AssetFare is best. A quote authorizes nothing. Do not authenticate,
prepare, sign, or submit unless the user separately approves continuation.

Choose the interface that already fits the agent

REST / OpenAPI

Primary and universal. Use the public five-field quote request without installing anything.

A2A v1

Use the canonical Agent Card and structured DataPart skill for quote-only A2A clients.

Agent Skill / Plugin

Install the repository skill or portable plugin when the host supports reusable agent instructions.

MCP

Optional adapter. Prefer its two v2 read-only tools; legacy workflow tools require separate explicit approval.

Machine-readable entry points