v1 is live

Add crypto swaps to your product. One API instead of 10+.

Let your users swap wallet to wallet, your app never takes custody, and you earn on every completed order. Get the lowest rate each time. Exclude any provider you (don't) like.

Free to use · Self-serve key, no sales call · Rate limits published

10+ Sources
300+ Assets
60+ Networks
POST /x/v1/quote Example
Your user sends 0.05 BTC
Receives on TRON USDT
10+ sources asked in parallel Your user receives
  1. 1 Exchange service Centralized 3,389.80 BEST
  2. 2 Exchange service Centralized 3,376.20 Next best
  3. 3 Cross-chain protocol Decentralized 3,371.05 Next best
  4. 4 Exchange service Centralized 3,352.40
  5. – Exchange service No quote for this pair
  6. – Exchange service Not answering — skipped

+ the other sources, asked at the same time

quote_id q_5mJc2Vq9… valid for 120 s Provider Kotova X
  • Non-custodial by design
  • OpenAPI 3.1 · Try-it console in the docs
  • Breaking changes only in a new version, 30 days ahead
  • Based in Germany, built for the EU framework

One integration instead of 9

Every source has its own sign-up, authentication, asset names, status codes and payout. Kotova X does that work for you, for centralized and decentralized sources alike. You integrate once.

Integrating each source yourself

9 integrations to maintain
  • SideShift Static secret header auth End-user IP for geo check
  • StealthEX Bearer token on every call Fixed rate needs a rate_id
  • FixedFloat HMAC-SHA256 signed body Per-order token for status
  • ChangeNOW Key in its own header Memo field named extraId
  • Chainflip No API key, broker-based Deposit channel open 24 h This exchange is a decentralized exchange offering low fees and has a No-KYC guarantee mid swap built in.
  • Changelly RSA-signed request bodies JSON-RPC 2.0, one endpoint
  • Exolix Raw key, no Bearer prefix 25-minute deposit window
  • CCE Cash HMAC-SHA256 with nonce Numeric statuses 1 to 9
  • Polyester Variable rate only Refund address mandatory This exchange is a decentralized exchange offering low fees and has a No-KYC guarantee mid swap built in.

And every new chain or asset means a change in each of them.

With Kotova X

1 integration
Your app1 key
Kotova X
  • SideShift
  • StealthEX
  • FixedFloat
  • ChangeNOW
  • Chainflip This exchange is a decentralized exchange offering low fees and has a No-KYC guarantee mid swap built in.
  • Changelly
  • Exolix
  • CCE Cash
  • Polyester This exchange is a decentralized exchange offering low fees and has a No-KYC guarantee mid swap built in.
  • One bearer key
  • One catalog, stable codes
  • One status list
  • One affiliate payout

Built for the product you run

Every one of these products has users who hold one coin and need another. Here is what the API does for each.

Wallets

Keep swaps inside your wallet

  • Your users stop leaving for an exchange when they want another coin.
  • One integration gives them the best offer across the connected sources.
  • If a source can't take the order, the next best one can take over.
POST /quotefallback_sourcesicon.url
Marketplaces & shops

Let buyers pay with what they hold

  • Swap the coin a buyer holds into the token your checkout needs.
  • Name the amount to receive; the quote returns what to send.
  • A minimum-receive guard refuses an order that would pay out less.
amount_type: tomin_receive_amount
Telegram bots

Swaps without a hot wallet

  • Your bot hands out a deposit address. No wallet keys or balances on your servers.
  • Kotova can e-mail your user about the order, with their consent.
  • One status list to show, whichever source runs the swap.
notification_emailGET /orders/{id}
Payments & checkout

Take BTC, settle in stablecoins

  • Fixed-rate quotes when the amount received must not move.
  • Pay out to a Lightning invoice of the exact amount.
  • Check an address before the order is created.
rate_type: fixedLightning/addresses/validate
Portfolio & DeFi apps

See a position, swap it on the spot

  • Native BTC, LTC and XMR next to EVM tokens and stablecoins.
  • No token approvals to sign: your user sends to a deposit address.
  • Where the source offers a choice, short or late deposits are settled in your app: continue or refund.
GET /pairsPOST /orders/{id}/resolve

Something else?

Exchanges, neobanks, games, AI agents — if your users need another coin, the API fits. Tell us what you are building.

api [at] kotova.io

The work behind one quote, done for you

Comparing, routing, failover and order problems are the hard parts of offering swaps. They are built in.

The best quote, ranked one way

Ranked by what your user receives — or, for a reverse quote, by what they send. What Kotova earns never weighs in.

Failover built in

A source that fails or is busy is skipped. If the best one can't take the order, the next best one named in the quote can take over. A source can go away without a change on your side.

Centralized and decentralized, one catalog

One list of currencies and networks with stable codes, whichever kind of source executes the swap. New sources and assets appear without new code.

Your app never takes custody

Your user sends to a deposit address the source issued and receives at their own address. The funds never pass through Kotova either.

Order problems solved in your app

A short deposit, a late one, a missing refund address: where the source offers a choice, the order lists what your user can do — continue or refund — and you offer it in your own screens.

Icons for every asset and network

Every currency, token and network comes with an icon URL on cdn.kotova.io, mirrored on assets.kotova.io.

One request, the whole comparison

Send your key as a bearer token. The answer names the winning source, the next best ones that would take over, and the notices your user has to see.

  • OpenAPI 3.1 spec and a Try-it console on every endpoint
  • The whole API as one file for your coding assistant: llms-full.txt
  • Idempotency-Key on orders: a retry never creates a second one
  • An X-Request-Id on every response; the weight and remaining budget in the headers of every keyed call
  • Source notices in English, German, Italian, Spanish, French and Russian
Full walkthrough in the Quickstart →
Request
curl https://api.kotova.io/x/v1/quote \
  -H "Authorization: Bearer $KOTOVA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": {"currency": "BTC", "network": "btc"},
    "to": {"currency": "USDT", "network": "trx"},
    "amount": "0.05",
    "amount_type": "from",
    "rate_type": "variable",
    "end_user_ip": "93.184.216.34"
  }'
200 OKResponse, shortened · X-Kotova-Weight: 1
{
  "quote_id": "q_5mJc2Vq9XkT3nR8bYw1LdP",
  "expires_at": "2026-11-10T10:17:03Z",
  "to": { "currency": "USDT", "network": "trx", "amount": "3389.8" },
  "provider": { "name": "Kotova X", "icon": { … } },
  "source": {
    "slug": "sideshift",
    "notice": { "text": "The exchange service is provided by SideShift. …" }
  },
  "fallback_sources": [
    { "source": { "slug": "changenow", … }, "to": { "amount": "3376.2" } }
  ]
}

What one integration saves you

Kotova X is built on the partner APIs of the sources it connects. You could integrate them one by one. This is what that involves.

Integrating each source yourself compared with integrating Kotova X
Topic Each source yourself With Kotova X
Sign-upA partner account and key per sourceOne self-serve key in your Kotova account
AuthenticationSigned request bodies, nonce-and-timestamp signatures, a secret plus your user's IPOne bearer key in one header
CatalogEach source names assets and networks its own way; you keep the mappingOne catalog with stable codes
StatusesEach source has its own codes, numeric at some, text at othersOne documented list of nine statuses
Order rulesDifferent quote lifetimes, minimums and refund-address rulesThe quote says what the order needs
Problem ordersEach source's own hold, refund and support processOne list of actions on the order, offered in your app
FailoverYour own fallback when a source is down or limits youBusy or failing sources are skipped; the next best can take the order
IconsFind, host and update them yourselfIcon URLs on a CDN, with a mirror
EarningsAn affiliate program, dashboard and payout per sourceOne affiliate profile, one payout
New sourcesEvery new source is a new integrationThey appear in the API without code changes

Based on the sources' public API documentation.

Earn on every completed order

Your API key belongs to your affiliate profile. Every order created with it earns you a share of Kotova's net revenue — the same as an order through your referral link. Orders that expire or are refunded earn nothing, and cost you nothing.

20%

of Kotova's net revenue on each completed order, by default

Ask for more

Request a higher rate or a higher rate limit on your account page.

Paid out in USDC or USDT on BNB Chain, Solana, Arbitrum or Ethereum — USDT on Tron too.

One profile

API orders and referral-link orders add up in one place.

Live in three steps

  1. Create your key

    Sign in at app.kotova.io, turn on two-factor authentication, generate your referral code and create the key. It is shown once: keep it on your server.

  2. Quote and show

    Request a quote and show it with Kotova X as the provider. Before your user confirms, show the notices of the source and its fallback sources.

  3. Create and follow

    Create the order with your user's address, show the deposit address the source issued, and read the order until it is final.

What v1 covers

In v1 today

  • Catalog, quotes, orders and 90 days of order history
  • Fixed and variable rates, reverse quotes, Lightning payouts
  • Order actions: continue, refund, refund address
  • E-mails to your user, minimum-receive guard, address check
  • An XML rates feed for rate monitors

Not there yet — and what to do instead

Webhooks
Read the order to follow it. The docs give a polling rhythm.
A sandbox
Quotes have no side effects. Test orders with a small real amount; an unfunded order simply expires.

Questions integrators ask

Is the API free?

Yes. The quoted rate already includes every service charge; network fees are separate.

Do my users need a Kotova account?

No. You need one, for the key. Your users stay in your app.

Who holds my users' funds?

Not your app and not Kotova. Your user sends to a deposit address the source issued for the order; a refund also comes from that source.

Does Kotova check identities?

Kotova performs no identity checks itself. Connected centralized sources may do so case by case.

Why does a quote return only one offer?

The API returns the best offer plus the next best ones as fallbacks. To let your users compare every offer, send them to app.kotova.io.

Can I leave a source out?

Yes. Send exclude_sources with the quote. The order then uses only the sources that quote names.

What are the rate limits?

250 units a minute per account by default. Most calls weigh 1, an order weighs 50. Ask for more on your account page.

What must my users see?

Kotova X as the provider, by name and icon, and — before they confirm — the notices of the quote's source and its fallback sources. Link the Kotova Terms of Service and Privacy Policy too. Display requirements

Ready to add swaps?

Create your key in a few minutes, or read the docs first.

Questions about an integration? api [at] kotova.io