Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: esimker Rates API
description: 'Prepaid travel data eSIMs. No account is needed: an order is addressed by
the secret token from its URL. Prices are USD strings, from $1.00.
Two ways to buy:
- **Storefront flow** (`catalog`, `orders`): pick a plan, `POST /api/orders`, send the
buyer to `checkout_url` to pay in crypto, then poll `GET /api/orders/{token}`
until `status` is `ready` — the eSIM (`esim.activation_code`) is in the payload.
- **Prepaid wallet** (`wallet`): `POST /api/wallet` mints a wallet whose secret code is
the only credential (`X-Wallet-Code`); `POST /api/wallet/deposits` opens a top-up
invoice and, with `currency` set, returns the coin address and the exact amount for a
payer with no browser; `POST /api/orders` with `payment_method: "wallet"` charges the
balance and issues at once (`client_ref` makes a retry return the same order).
- **Reseller API** (`reseller`): white-label partners on `X-API-Key`, retail minus a
discount; keys are issued by support.
The wallet and the catalogue are also MCP tools at `POST https://esimker.com/api/mcp`
(Streamable HTTP; the wallet code goes in `Authorization: Bearer`).
The guide for agents is https://esimker.com/agents (the wallet: https://esimker.com/agents#wallet).
**Buyer accounts** (`account`) are the storefront''s own cabinet: an address and a password
as a second way for a person to reach their orders and wallets, on a session cookie with a
CSRF echo. An account is optional and nothing above needs one — an agent keeps the order
token and the wallet code, and has no use for these routes.'
version: '1'
tags:
- name: Rates
paths:
/api/rates:
get:
tags:
- Rates
summary: Exchange Rates
description: '`{"rates": {"AMD": {"rate": "360.88", "date": "2026-10-26", "source": "cba"}}}`
— how many drams one US dollar buys, and the date the rate is for.'
operationId: exchange_rates_api_rates_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response Exchange Rates Api Rates Get