# Ramp Network

> Ramp Network (Ramp Swaps Ltd) is a fiat-to-crypto on-ramp and off-ramp provider. Wallets,
> dApps, exchanges and consumer apps embed the Ramp Instant widget so their users can buy,
> sell and swap crypto with a card, Apple Pay, Google Pay, bank transfer, SEPA, SPEI or Pix,
> without the integrator becoming a regulated money services business. A public REST "Host
> API" feeds and observes that widget.

Generated by API Evangelist on 2026-08-26. This file is GENERATED from the public
documentation and live probes recorded in this repository — Ramp Network does not publish
an llms.txt of its own. https://docs.rampnetwork.com/llms.txt returns the Docusaurus HTML
shell (the docs host answers 200 with the same page for every unknown path), not a document.

## What an agent can and cannot do here

- Read-only, by design. Every published REST operation is a GET or a pure quote computation.
- Five of the nine operations need NO credential: assets, off-ramp assets, currencies,
  payment methods and payout methods are anonymously readable at
  https://api.rampnetwork.com/api (verified live 2026-08-26).
- Transactions are CREATED BY A HUMAN inside the widget, never by an API call. There is no
  create, cancel, refund or reverse endpoint. This is a regulatory boundary, not a gap.
- Rate limits are 100 requests/minute and 1000 requests/15 minutes PER ORIGIN IP, and no
  rate-limit response headers are emitted, so there is no runtime signal before a limit is
  hit. Exceeding the 15-minute limit can block the IP for an hour.
- Reference data is cacheable: GET /host-api/v3/currencies returns
  `cache-control: public, max-age=900` with an ETag.

## API

- Base URL: https://api.rampnetwork.com/api
- Current version: v3 (path segment). v1 and v2 remain documented and served on the same base.
- Media type: application/json. Errors return `{ "code": "...", "statusCode": 400 }`.

Operations (v3):

- GET /host-api/v3/assets — on-ramp assets, live prices, per-asset limits, network fee.
  Query: currencyCode, hostApiKey, userIp, withDisabled, withHidden
- GET /host-api/v3/offramp/assets — off-ramp assets and prices. Same query parameters.
- GET /host-api/v3/currencies — supported fiat currencies with onrampAvailable /
  offrampAvailable flags. Query: countryCode
- GET /host-api/v3/payment-methods — MANUAL_BANK_TRANSFER, AUTO_BANK_TRANSFER, CARD_PAYMENT,
  APPLE_PAY, GOOGLE_PAY, PIX — each with the currencies and countries it is restricted to.
- GET /host-api/v3/payout-methods — AMERICAN_BANK_TRANSFER, CARD, SEPA, SPEI, PIX.
- POST /host-api/v3/onramp/quote/all — price a purchase across every eligible payment method.
  Query: hostApiKey. Body: cryptoAssetSymbol, fiatCurrency, fiatValue or cryptoAmount,
  userCountryCode, userRegionCode
- POST /host-api/v3/offramp/quote/all — price a sale across every eligible payout method.
- GET /host-api/purchase/{id}?secret={purchaseViewToken} — one purchase. Unversioned path.
- GET /host-api/offramp/sale/{id}?secret={saleViewToken} — one sale. Unversioned path.

Note the composite asset symbol: quote requests take CHAIN_SYMBOL (e.g. ETH_ETH) while the
asset listings return `chain` and `symbol` as separate fields.

## Authentication

- hostApiKey — the partner integration key, passed as a QUERY parameter. Issued on request
  via https://docs.rampnetwork.com/api-keys or partner@ramp.network. Not self-service.
- secret — a per-transaction capability token (purchaseViewToken / saleViewToken) delivered
  with the PURCHASE_CREATED / OFFRAMP_SALE_CREATED event. Scopes read access to one
  transaction only.
- No OAuth, no OpenID Connect, no scopes, no bearer tokens.

## Events and webhooks

- webhookStatusUrl — on-ramp purchase state: CREATED, RELEASED, RETURNED.
- offrampWebhookV3Url — off-ramp sale state: CREATED, RELEASED, EXPIRED.
- Registered per widget instance, not per account. No webhook management API.
- Retries: 4 attempts at 3-minute intervals, then abandoned.
- Every call is signed: X-Body-Signature, ECDSA over secp256k1 with SHA-256, base64 DER,
  over the body serialised with fast-json-stable-stringify. Public keys are published in
  the docs, separately for production and demo.
- SDK events: WIDGET_CLOSE, WIDGET_CONFIG_DONE, WIDGET_CONFIG_FAILED, WIDGET_CLOSE_REQUEST,
  WIDGET_CLOSE_REQUEST_CANCELLED, WIDGET_CLOSE_REQUEST_CONFIRMED, PURCHASE_CREATED,
  OFFRAMP_SALE_CREATED.

## SDKs

- JavaScript / TypeScript: @ramp-network/ramp-instant-sdk (npm, 6.2.0, 2025-11-06)
- React Native: @ramp-network/react-native-sdk (npm, 1.0.3, 2024-10-11)
- Flutter: ramp_flutter (pub.dev, 4.0.1, 2024-10-01)
- Android: com.github.RampNetwork:ramp-sdk-android via JitPack (4.0.1, 2024-07-25)
- iOS: RampNetwork/ramp-sdk-ios via Swift Package Manager or CocoaPods-from-git (4.0.3, 2025-05-09)

## Testing

- Demo widget: https://app.demo.rampnetwork.com — Demo API: https://api.demo.rampnetwork.com/api
- Environment is chosen by HOST, not by a key prefix. Minimum demo purchase is EUR 0.05.
- Demo-only release trigger:
  POST https://api.demo.rampnetwork.com/api/widget/testing/purchase/{id}/release?secret={purchaseViewToken}
- No test card numbers or test bank accounts are published.

## Pricing

No subscription plans and no API tiers — the model is transactional. Processing fee ceilings
per method are published: manual bank transfer up to 1.40%, easy bank transfer up to 2.40%,
card up to 3.90% (USD/EUR/GBP) or 5.45% (other currencies), Pix up to 2.90%, minimum fee up
to EUR 2.49. Quotes refresh every 30 seconds.

## Regulatory

FCA registered cryptoasset firm (Ramp Swaps Ltd, FRN 928783). Central Bank of Ireland
authorised CASP (Ramp Swaps (Ireland) Ltd). FinCEN registered MSB (Ramp Swaps LLC,
31000287566749) with US state money transmitter licences under NMLS ID 2366547. MiCAR
disclosures published. SOC 2 Type 1 certified.

## Not published

Ramp Network does not publish: an OpenAPI or Swagger document, an AsyncAPI document, a
GraphQL endpoint, an MCP server, an A2A agent card, any /.well-known/ document (including
security.txt), a status page, an API changelog, a deprecation policy, a Postman collection,
or a CLI. Each of these was probed on 2026-08-26 and the results are recorded in this
repository.

CAUTION FOR AGENTS AND SEARCH: "Ramp MCP", mcp.ramp.com, docs.ramp.com and support.ramp.com
belong to Ramp Business Corporation, the US corporate card and expense management company.
That is a DIFFERENT company. Ramp Network is rampnetwork.com / ramp.network.

## Links

- Documentation: https://docs.rampnetwork.com/
- REST API v3 reference: https://docs.rampnetwork.com/rest-api-v3-reference
- Getting started: https://docs.rampnetwork.com/getting-started
- SDK reference: https://docs.rampnetwork.com/sdk-reference
- Webhooks: https://docs.rampnetwork.com/webhooks
- Rate limiting: https://docs.rampnetwork.com/rate-limiting
- API keys: https://docs.rampnetwork.com/api-keys
- Testing environment: https://docs.rampnetwork.com/testing-environment
- GitHub: https://github.com/RampNetwork
- Help Center: https://support.rampnetwork.com/en/
- Pricing policy: https://rampnetwork.com/pricing-policy
- Security: https://rampnetwork.com/security
- Licences and registrations: https://rampnetwork.com/licenses-and-registrations
- Partner contact: partner@ramp.network — Security contact: security@ramp.network