# Rampa

> Real-time LATAM stablecoin cash-out, FX, spreads, yields and fee intelligence for AI agents. Pay-per-request in USDC on Algorand via the x402 protocol. No account, no API keys, no subscription.

Rampa is the only real-world-money data API on the x402 network. While most x402 endpoints serve crypto data to crypto agents, Rampa answers a concrete question an agent moving money in Latin America needs: "given an amount, a stablecoin and a country, what's the best net way to turn it into local currency — and what does it really cost?"

## How payment works
Every /v1/* endpoint returns HTTP 402 Payment Required when called without payment. Pay with an x402-compatible client in USDC on Algorand (settled via the GoPlausible facilitator, gasless for the caller). Retry with the X-PAYMENT header to receive the response. Prices are per request.

## Endpoints
- GET /v1/route?amount={n}&asset={USDC|USDT}&country={AR|BR|MX|CL|CO|PE|UY|PY|BO|DO|VE} — $0.05
  Best NET cash-out route (sell side): top exchange, gross fiat, withdrawal fee, net received, effective rate, ranked alternatives. Fields: best, alternatives, confidence, sources, global (USD reference + implied FX), warnings.
- GET /v1/spread?country={..}&asset={..} — $0.03
  Buy/sell spread per exchange + cross-exchange arbitrage (cheapest buy vs best sell). Fields: cheapestBuy, bestSell, crossSpreadPct, arbitrage, perExchange, warnings.
- GET /v1/yields?asset={SOL|USDC|..}&type={all|cefi|defi}&limit={n} — $0.02
  Best APY to hold an asset, comparing CeFi remunerated accounts (exchanges) and DeFi protocols (Aave, Lido, Curve, Morpho…) side by side, with TVL and IL risk.
- GET /v1/fees?asset={USDC|..}&network={ETHEREUM|SOLANA|ALGORAND|TRON|..} — $0.02
  Withdrawal fees per exchange and network (incl. Algorand), ranked cheapest-first, plus taker trading fee where known.
- GET /v1/rates?country={..}&asset={..}&amount={n} — $0.01
  Normalized buy & sell quotes across all sources for one country.

## Machine-readable specs
- /openapi.json — full OpenAPI 3.1 specification of every endpoint, parameters and response shapes.
- /.well-known/agent-card.json — A2A agent card listing the five skills.
- /.well-known/x402.json — x402 merchant metadata.

## Free endpoints (no payment)
- GET /app — free public comparison tool for humans (Spanish): where to buy or sell stablecoins in 11 LATAM countries.
- GET /demo — live headline: best AR USDC cash-out rate (for humans/preview).
- GET /v1/countries — supported countries and assets.
- GET /health — service status.

## Data model notes
- Every quote is tagged with marketType: exchange | broker | p2p | dex | reference — so you know what you're reading.
- confidence: high (cross-checked against an independent reference or two independent exchange feeds), medium, low (single source).
- Prices go direct to exchange APIs (Bitso, Buda, Mercado Bitcoin, SatoshiTango, Lemon) and Binance P2P where the market is P2P; an international reference (OKX/Gate) anchors the USD value and exposes the local FX gap.

## Coverage
11 countries: Argentina, Brazil, Mexico, Chile, Colombia, Peru, Uruguay, Paraguay, Bolivia, Dominican Republic, Venezuela.

## Disclaimer
Informational market data from public sources. Not financial advice. Verify amounts on the exchange before operating.