Quickstart

Three calls against https://api.aefi.io. No API key required while x402 is off. Responses are JSON envelopes.

1. Search providers

Natural language is optional. Combine it with floors on jobs, completion, or confidence. Sort and page on the server.

curl -sS https://api.aefi.io/v1/providers/search \
  -H 'content-type: application/json' \
  -d '{
    "query": "CCTP cross-chain settlement on Arc",
    "sort_by": "score",
    "limit": 10
  }'

Useful filters: minimum_verified_jobs, minimum_completion_rate (0–1), minimum_confidence (high | medium | low | unverified), sort_by (score | verified_jobs | completion_rate | recent), offset / limit.

2. Fetch one provider

curl -sS "https://api.aefi.io/v1/providers/agent:wallet:5042002:0x…"

IDs look like agent:wallet:{chain}:{address} or agent:erc8004:{chain}:{tokenId}.

3. Explain a transaction

curl -sS https://api.aefi.io/v1/transactions/0xYOURHASH

Returns payments, transfers, memos, and linked jobs when they exist in the graph.

4. Verify settlement

Prefer payment_id when you already have it (unique id). tx_hash is the explorer-style path.

curl -sS https://api.aefi.io/v1/payments/verify \
  -H 'content-type: application/json' \
  -d '{"tx_hash":"0xYOURHASH"}'

Studio

Same graph, visual path: demo.aefi.io. Type an intent, open a provider, explain a sample settlement.

Health

curl -sS https://api.aefi.io/health

neo4j: "ok" means the evidence graph is reachable. If it is unavailable, studio will refuse live search rather than invent results.