# LandedFX

> LandedFX is an FX routing API. It prices what actually lands when money moves between 25 local currencies and any stablecoin, across P2P venues, payment rails, chains and swap providers, at your exact size. It also prices naira rate locks and carry, and builds non-custodial deposits into the Carry vault on Base.

- API base URL: https://api.landedfx.com/api/v1
- OpenAPI spec: https://api.landedfx.com/openapi.json
- MCP server (Streamable HTTP): https://api.landedfx.com/mcp
- Auth: optional `x-api-key` header. Most endpoints work without a key; `POST /quotes` needs one. Get a free key (5,000 calls a month) with `POST /api/v1/keys`.


## Getting started

- [Introduction](https://docs.landedfx.com/index.md): The landed price of money. One API call for what moving between a local currency and a stablecoin really costs, at your size.
- [Quickstart](https://docs.landedfx.com/quickstart.md): Get a key, price your first route, and read the result.
- [Authentication & errors](https://docs.landedfx.com/authentication.md): API keys, rate limits, the response envelope and error handling.

## Concepts

- [Asset notation](https://docs.landedfx.com/concepts/notation.md): How to name what you send and what should arrive.
- [All-in cost](https://docs.landedfx.com/concepts/all-in-cost.md): How allInBps is measured, and why it's the one number to compare.
- [Fees](https://docs.landedfx.com/concepts/fees.md): Everything LandedFX charges, what other parties charge, and who receives each.
- [How routing works](https://docs.landedfx.com/concepts/routing.md): What the router considers, and how it picks.
- [Payment rails](https://docs.landedfx.com/concepts/rails.md): Pricing the way money actually moves on the local side.
- [Counterparty screening](https://docs.landedfx.com/concepts/screening.md): How P2P ads with risky terms are kept out of your routes.
- [Confidence](https://docs.landedfx.com/concepts/confidence.md): How sure LandedFX is that the quoted price will hold.

## Guides

- [Recipes](https://docs.landedfx.com/guides/recipes.md): Copy-ready builds, from a live payout quote to Earn inside your app with your own fee.
- [Local currency → stablecoin](https://docs.landedfx.com/guides/onramp.md): Price a pay-in in local currency that lands as a stablecoin on any chain.
- [Stablecoin → local currency](https://docs.landedfx.com/guides/offramp.md): Price a payout from a stablecoin into local currency on a payment rail.
- [Cross-border, local to local](https://docs.landedfx.com/guides/cross-border.md): Move value from one local currency to another through USDT.
- [Rate locks](https://docs.landedfx.com/guides/rate-locks.md): Lock today's naira rate for a payment you'll make or receive later.
- [Naira carry](https://docs.landedfx.com/guides/carry.md): Compare ways to earn naira rates in dollars, priced from live markets.
- [Vaults](https://docs.landedfx.com/guides/vaults.md): Let your users earn dollar yield in USDC, with one confirmation and no custody.
- [Executing swap legs](https://docs.landedfx.com/guides/executable-swaps.md): Turn a priced stablecoin leg into a transaction your wallet signs.
- [Webhooks](https://docs.landedfx.com/guides/webhooks.md): Get a signed POST when money moves in a vault or the naira risk level changes, instead of polling.
- [Market data](https://docs.landedfx.com/guides/market-data.md): Benchmark corridors with live and historical executable costs.
- [Build with AI](https://docs.landedfx.com/guides/ai-tools.md): Connect Claude, Cursor, ChatGPT or any MCP client to live LandedFX quotes, market data, vaults and these docs.

## Reference

- [Coverage](https://docs.landedfx.com/coverage.md): Currencies, venues, rails and chains LandedFX prices today.
- [API reference](https://docs.landedfx.com/api-reference.md): Every endpoint, generated from the LandedFX OpenAPI document.
- [Changelog](https://docs.landedfx.com/changelog.md): What's new in the LandedFX API.

## API endpoints

- `GET /api/v1/health`: Service health
- `POST /api/v1/keys`: Get a free API key
- `GET /api/v1/usage`: Your plan and usage this month
- `GET /api/v1/currencies`: List covered currencies
- `GET /api/v1/currencies/{code}`: Live rate and rails for a currency
- `GET /api/v1/currencies/{code}/ads`: Ads usable at a size
- `GET /api/v1/swap/assets`: Assets the swap layer routes
- `POST /api/v1/swap/quotes`: Best-of Relay and NEAR Intents
- `GET /api/v1/swap/status`: Track a swap
- `POST /api/v1/quotes`: Quote a transfer
- `GET /api/v1/quotes/recent`: Latest quotes served
- `GET /api/v1/quotes/{id}`: Read a quote by id
- `GET /api/v1/market/overview`: Coverage and the real cost of every corridor
- `GET /api/v1/market/history/{code}`: Corridor history
- `GET /api/v1/market/swap-costs`: Stablecoin swap cost by chain and provider
- `POST /api/v1/leads`: Request design-partner access
- `GET /api/v1/derivatives/ngn`: Naira derivatives: index, futures curve and options chain
- `POST /api/v1/forwards`: Lock a rate for later
- `POST /api/v1/carry/quotes`: Price ways to earn naira rates in dollars
- `GET /api/v1/vaults`: Carry vaults and their live state
- `GET /api/v1/vaults/{id}`: A vault: TVL, share price, liquidity, fees and allocations
- `GET /api/v1/vaults/{id}/accounts/{account}`: A wallet's position: shares, value and what it can withdraw now
- `GET /api/v1/vaults/{id}/history`: Share price and TVL over time, with realised APY
- `POST /api/v1/vaults/{id}/deposit-routes`: Deposit from any token on any chain
- `POST /api/v1/vaults/{id}/transactions`: Build a deposit, withdrawal or redemption to sign

## Optional

- [Full docs in one file](https://docs.landedfx.com/llms-full.txt)