Quote a transfer

POST

/api/v1/quotes

POST

/api/v1/quotes

Prices every route between from and to at your size, across P2P venues, payment rails, withdrawal networks and swap providers, and returns the best with up to four alternatives.

Authorization

apiKey

headerx-api-key<token>

Request Body

application/json

body

from*string

What you send: a local currency, optionally with a payment rail (KES, KES:mpesa), or a token (USDT:tron).

to*string

What should arrive, in the same notation.

amount*string

Amount of from, as a decimal string.

maxAds?number

Most counterparties a P2P leg may use. Large orders are split across ads up to this cap; 1 forces a single ad.

Range1 <= value <= 25

Default25

Response Body

application/json

response

code*number

HTTP status code

message*string

Human-readable message

data?

Response payload

metadata?

errors?array<string>

Validation errors, when the request was rejected

Example Request

curl -X POST 'https://api.landedfx.com/api/v1/quotes' \
  -H 'Content-Type: application/json' \
  -d '{
  "from": "KES:mpesa",
  "to": "USDC:base",
  "amount": "150000"
}'

Example Request

curl -X POST 'https://api.landedfx.com/api/v1/quotes' \  -H 'Content-Type: application/json' \  -d '{  "from": "KES:mpesa",  "to": "USDC:base",  "amount": "150000"}'

Example ResponseSchema

{
  "message": "string",
  "metadata": {
    "page": 1,
    "limit": 20,
    "totalDocs": 42,
    "prevPage": null,
    "nextPage": 2,
    "totalPages": 3
  },
  "errors": [
    "string"
  ],
  "code": 201,
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "from": "KES:mpesa",
    "to": "USDC:base",
    "amountIn": "150000",
    "amountOut": "1146.27",
    "effectiveRate": "0.0076418",
    "idealAmountOut": "string",
    "allInBps": 42.7,
    "route": {
      "summary": "Buy USDT on Binance P2P → Withdraw on BNB Chain → Swap via NEAR Intents",
      "venue": "string",
      "network": "tron",
      "amountOut": "1146.27",
      "effectiveRate": "0.0076418",
      "allInBps": 42.7,
      "steps": [
        {
          "kind": "p2p_buy",
          "venue": "binance",
          "title": "Buy USDT on Binance P2P",
          "detail": "MONSTER_OG_LEGACY at 130.48 KES/USDT via M-PESA Kenya (Safaricom) · 99.1% completion, 950 orders",
          "amountIn": "150000",
          "assetIn": "KES",
          "amountOut": "1149.601471",
          "assetOut": "USDT",
          "costBps": 31.4,
          "executable": true,
          "meta": {}
        }
      ]
    },
    "alternatives": [
      {
        "summary": "Buy USDT on Binance P2P → Withdraw on BNB Chain → Swap via NEAR Intents",
        "venue": "string",
        "network": "tron",
        "amountOut": "1146.27",
        "effectiveRate": "0.0076418",
        "allInBps": 42.7,
        "steps": [
          {
            "kind": "p2p_buy",
            "venue": "binance",
            "title": "Buy USDT on Binance P2P",
            "detail": "MONSTER_OG_LEGACY at 130.48 KES/USDT via M-PESA Kenya (Safaricom) · 99.1% completion, 950 orders",
            "amountIn": "150000",
            "assetIn": "KES",
            "amountOut": "1149.601471",
            "assetOut": "USDT",
            "costBps": 31.4,
            "executable": true,
            "meta": {}
          }
        ]
      }
    ],
    "confidence": {
      "level": "high",
      "reasons": [
        "string"
      ]
    },
    "legs": [
      {
        "side": "buy",
        "currency": "KES",
        "rail": "mpesa",
        "midRate": 0,
        "usableAds": 0,
        "consideredAds": 0,
        "screenedAds": 0,
        "adsInBestFill": 0,
        "excluded": {},
        "depthSpreadBps": 0
      }
    ],
    "warnings": [
      "string"
    ],
    "latencyMs": 0,
    "expiresAt": "2019-08-24T14:15:22Z",
    "createdAt": "2019-08-24T14:15:22Z"
  }
}

{  "message": "string",  "metadata": {    "page": 1,    "limit": 20,    "totalDocs": 42,    "prevPage": null,    "nextPage": 2,    "totalPages": 3  },  "errors": [    "string"  ],  "code": 201,  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "from": "KES:mpesa",    "to": "USDC:base",    "amountIn": "150000",    "amountOut": "1146.27",    "effectiveRate": "0.0076418",    "idealAmountOut": "string",    "allInBps": 42.7,    "route": {      "summary": "Buy USDT on Binance P2P → Withdraw on BNB Chain → Swap via NEAR Intents",      "venue": "string",      "network": "tron",      "amountOut": "1146.27",      "effectiveRate": "0.0076418",      "allInBps": 42.7,      "steps": [        {          "kind": "p2p_buy",          "venue": "binance",          "title": "Buy USDT on Binance P2P",          "detail": "MONSTER_OG_LEGACY at 130.48 KES/USDT via M-PESA Kenya (Safaricom) · 99.1% completion, 950 orders",          "amountIn": "150000",          "assetIn": "KES",          "amountOut": "1149.601471",          "assetOut": "USDT",          "costBps": 31.4,          "executable": true,          "meta": {}        }      ]    },    "alternatives": [      {        "summary": "Buy USDT on Binance P2P → Withdraw on BNB Chain → Swap via NEAR Intents",        "venue": "string",        "network": "tron",        "amountOut": "1146.27",        "effectiveRate": "0.0076418",        "allInBps": 42.7,        "steps": [          {            "kind": "p2p_buy",            "venue": "binance",            "title": "Buy USDT on Binance P2P",            "detail": "MONSTER_OG_LEGACY at 130.48 KES/USDT via M-PESA Kenya (Safaricom) · 99.1% completion, 950 orders",            "amountIn": "150000",            "assetIn": "KES",            "amountOut": "1149.601471",            "assetOut": "USDT",            "costBps": 31.4,            "executable": true,            "meta": {}          }        ]      }    ],    "confidence": {      "level": "high",      "reasons": [        "string"      ]    },    "legs": [      {        "side": "buy",        "currency": "KES",        "rail": "mpesa",        "midRate": 0,        "usableAds": 0,        "consideredAds": 0,        "screenedAds": 0,        "adsInBestFill": 0,        "excluded": {},        "depthSpreadBps": 0      }    ],    "warnings": [      "string"    ],    "latencyMs": 0,    "expiresAt": "2019-08-24T14:15:22Z",    "createdAt": "2019-08-24T14:15:22Z"  }}

Quote a transfer

AuthorizationCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

Authorization

Request Body

Response Body