Get trade quote Run in API Explorer

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://docs.lumetrade.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "Lumetrade API MCP server": {
    "url": "https://docs.lumetrade.com/mcp"
  }
}
Close
POST /api/v1/trades/quote
X api key & X api secret

Requests an RFQ quote for the authenticated API key owner.

application/json

Body Required

  • amount number Required

    Trade amount. Interpreted by amountMode.

  • fromCurrency string

    Currency to send.

    Minimum length is 1.

  • toCurrency string

    Currency to buy/receive.

    Minimum length is 1.

  • quoteIntent string

    Use client_linked for a confirmable quote, or indicative for a preview.

    Format should match the following pattern: (?i)indicative|client_linked. Values are indicative or client_linked.

  • amountMode string

    base means amount is the send amount; quote means amount is the receive amount.

    Format should match the following pattern: (?i)base|quote. Values are base or quote.

Responses

  • 200 application/json

    Quote returned successfully

    Hide response attributes Show response attributes object
    • amount number

      Quoted request amount.

    • fromCurrency string

      Currency sold/sent.

    • toCurrency string

      Currency bought/received.

    • toAmount number

      Amount bought/received.

    • rate number

      Quoted rate.

    • quoteStr string

      Confirmable quote string. Empty for indicative quotes.

    • fromAmount string

      Amount sold/sent as a string for exact confirmation.

    • quoteAmountMode boolean

      Whether the request amount was the receive amount.
  • 400 application/json

    Quote request validation failed

    Hide response attributes Show response attributes object
    • amount number

      Quoted request amount.

    • fromCurrency string

      Currency sold/sent.

    • toCurrency string

      Currency bought/received.

    • toAmount number

      Amount bought/received.

    • rate number

      Quoted rate.

    • quoteStr string

      Confirmable quote string. Empty for indicative quotes.

    • fromAmount string

      Amount sold/sent as a string for exact confirmation.

    • quoteAmountMode boolean

      Whether the request amount was the receive amount.
POST /api/v1/trades/quote 
curl \
 --request POST 'https://api.lumetrade.com/api/v1/trades/quote' \
 --header "X-API-KEY: $API_KEY" \
 --header "X-API-SECRET: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"amount":100,"fromCurrency":"USDT","toCurrency":"ZAR","quoteIntent":"client_linked","amountMode":"base"}'
Request examples 
{
  "amount": 100,
  "fromCurrency": "USDT",
  "toCurrency": "ZAR",
  "quoteIntent": "client_linked",
  "amountMode": "base"
}
Response examples (200) 
{
  "amount": 100,
  "fromCurrency": "USDT",
  "toCurrency": "ZAR",
  "toAmount": 1840,
  "rate": 18.4,
  "quoteStr": "rfq_quote_7K9Q2M",
  "fromAmount": 100,
  "quoteAmountMode": false
}
Response examples (400) 
{
  "amount": 100,
  "fromCurrency": "USDT",
  "toCurrency": "ZAR",
  "toAmount": 1840,
  "rate": 18.4,
  "quoteStr": "rfq_quote_7K9Q2M",
  "fromAmount": 100,
  "quoteAmountMode": false
}