# IoMarkets API

**Canonical:** https://apis.io/apis/iomarkets-app/iomarkets-app-api/  
**Provider:** IoMarkets — https://apis.io/providers/iomarkets-app/  
**Documentation:** https://iomarkets.app/v1/referrals

IoMarkets API is one of 2 APIs that [IoMarkets](https://apis.io/providers/iomarkets-app/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

IoMarkets API as documented publicly: 14 operations. Contract generated from the documentation by API Evangelist (2026-11-12); not the provider's own document.

## Operations (14)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/catalog` | List offers for a given type and optional country |
| GET | `/v1/countries` | List every destination a product reaches |
| GET | `/v1/fx` | Get indicative USDC↔local rate and estimate for a payout |
| GET | `/v1/ledger` | Public ledger with aggregated order statistics |
| GET | `/v1/links` | Retrieve state of a specific pay link |
| POST | `/v1/links` | Add "ref": "<your Algorand address>" to POST https://iomarkets.app/v1/quote or POST https://iomarkets.app/v1/links. |
| GET | `/v1/lookup` | Discover operator and top‑up offers for a phone number |
| GET | `/v1/orders` | Poll an order until it reaches a terminal state |
| POST | `/v1/orders` | Pay for a quote (x402 payment flow) |
| GET | `/v1/pubkey` | Retrieve the server's ed25519 public key for receipt verification |
| POST | `/v1/quote` | Add "ref": "<your Algorand address>" to POST https://iomarkets.app/v1/quote or POST https://iomarkets.app/v1/links. |
| GET | `/v1/referrals` | Earn: referral share, paid on-chain |
| POST | `/v1/verify` | Verify a receipt or whole order response signature |
| POST | `/v1/vouchers/quote` | Group eSIMs: one payment, N claim links. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/iomarkets-app/openapi/_ae-authored/iomarkets-app-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/iomarkets-app/json-schema/iomarkets-app-post-v1-vouchers-quote-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/iomarkets-app/json-schema/iomarkets-app-get-v1-ledger-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/iomarkets-app/json-schema/iomarkets-app-get-v1-orders-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/iomarkets-app/json-schema/iomarkets-app-post-v1-verify-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/iomarkets-app/json-schema/iomarkets-app-post-v1-vouchers-quote-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/iomarkets-app/json-schema/iomarkets-app-post-v1-orders-response-schema.json

## Other IoMarkets APIs (1)

- [IoMarkets API](https://apis.io/apis/iomarkets-app/iomarkets-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/iomarkets-app/iomarkets-app-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/iomarkets-app/.