> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rampnow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a quote



## OpenAPI

````yaml /api-reference/partner_external.yaml post /api/partner/v1/ext/ramp_order/quote
openapi: 3.1.0
info:
  description: API for partner_external service
  title: partner service
  version: 0.0.1
servers:
  - description: Base URL for Production Rampnow APIs
    url: https://api.rampnow.io
  - description: Base URL for Sandbox Rampnow APIs
    url: https://api.sandbox.rampnow.io
security:
  - apiKeyAuth: []
paths:
  /api/partner/v1/ext/ramp_order/quote:
    post:
      tags:
        - Onramp & Offramp Intent
      summary: Get a quote
      operationId: GetRampOrderQuote
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetRampOrderQuoteRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  code:
                    type: integer
                  data:
                    $ref: '#/components/schemas/GetOrderRampQuoteResponse'
                  displayError:
                    description: For client display
                    type: string
                  message:
                    type: string
                  traceId:
                    type: string
                required:
                  - code
                  - message
                  - traceId
                  - data
                type: object
          description: OK
components:
  schemas:
    GetRampOrderQuoteRequest:
      description: >-
        GetRampOrderQuoteRequest asks for a non-binding price quote for a ramp
        order. Supply exactly one

        of `srcAmount` / `dstAmount` — the other side is computed.
      properties:
        dstAmount:
          description: Destination-side amount; set this OR `srcAmount`, not both
          type: string
        dstChain:
          description: >-
            Destination chain (`fiat` for fiat legs)


            Supported Blockchains like ethereum, bitcoin etc. For additional
            options, see the [full list](/quickstart/resources/blockchain-list).
          externalDocs:
            description: Supported Blockchains like ethereum, bitcoin etc.
            url: https://docs.rampnow.io/quickstart/resources/blockchain-list
          type: string
        dstCurrency:
          description: >-
            Destination currency


            Supported Crypto Currencies like EUR, USDT etc. For additional
            options, see the [full
            list](/quickstart/resources/supported-assets).
          externalDocs:
            description: Supported Crypto Currencies like EUR, USDT etc.
            url: https://docs.rampnow.io/quickstart/resources/supported-assets
          type: string
        orderType:
          $ref: '#/components/schemas/OrderType'
          description: Order direction (`buy`, `sell`, …)
        partnerFixedFee:
          description: Overrides the account-side partner fixed fee for this quote
          type: number
        partnerPctFee:
          description: Overrides the account-side partner fee percentage for this quote
          type: number
        paymentMode:
          description: >-
            Preferred payment method — quote may differ across modes


            Payment Methods & Limits like sepa, card, wire etc. For additional
            options, see the [full
            list](/quickstart/resources/payment-methods#payment-methods).
          externalDocs:
            description: Payment Methods & Limits like sepa, card, wire etc.
            url: >-
              https://docs.rampnow.io/quickstart/resources/payment-methods#payment-methods
          type: string
        srcAmount:
          description: Source-side amount; set this OR `dstAmount`, not both
          type: string
        srcChain:
          description: >-
            Source chain (`fiat` for fiat legs)


            Supported Blockchains like ethereum, bitcoin etc. For additional
            options, see the [full list](/quickstart/resources/blockchain-list).
          externalDocs:
            description: Supported Blockchains like ethereum, bitcoin etc.
            url: https://docs.rampnow.io/quickstart/resources/blockchain-list
          type: string
        srcCurrency:
          description: >-
            Source currency


            Supported Crypto Currencies like EUR, USDT etc. For additional
            options, see the [full
            list](/quickstart/resources/supported-assets).
          externalDocs:
            description: Supported Crypto Currencies like EUR, USDT etc.
            url: https://docs.rampnow.io/quickstart/resources/supported-assets
          type: string
      required:
        - orderType
        - srcCurrency
        - srcChain
        - dstChain
        - dstCurrency
      type: object
    GetOrderRampQuoteResponse:
      description: >-
        GetOrderRampQuoteResponse is the priced quote for the requested route.
        Non-binding — the actual

        order may re-quote at creation time.
      properties:
        dstAmount:
          description: Quoted destination amount (equals input if `dstAmount` was supplied)
          type: string
        dstChain:
          description: >-
            Echoes the destination chain


            Supported Blockchains like ethereum, bitcoin etc. For additional
            options, see the [full list](/quickstart/resources/blockchain-list).
          externalDocs:
            description: Supported Blockchains like ethereum, bitcoin etc.
            url: https://docs.rampnow.io/quickstart/resources/blockchain-list
          type: string
        dstCurrency:
          description: >-
            Echoes the destination currency


            Supported Crypto Currencies like EUR, USDT etc. For additional
            options, see the [full
            list](/quickstart/resources/supported-assets).
          externalDocs:
            description: Supported Crypto Currencies like EUR, USDT etc.
            url: https://docs.rampnow.io/quickstart/resources/supported-assets
          type: string
        exchangeRate:
          description: >-
            Effective FX/crypto rate for this quote (destination per source
            unit)
          type: string
        feeDetails:
          description: Fee breakdown applied to the quote — see FeeDetail
          items:
            $ref: '#/components/schemas/FeeDetail'
          type: array
        message:
          description: >-
            Message carries a human-readable note when no quote could be
            producedHuman-readable note, populated when the quote could not be
            produced
          type: string
        orderType:
          $ref: '#/components/schemas/OrderType'
          description: Echoes the requested order type
        paymentMode:
          description: >-
            Payment mode the quote was priced against


            Payment Methods & Limits like sepa, card, wire etc. For additional
            options, see the [full
            list](/quickstart/resources/payment-methods#payment-methods).
          externalDocs:
            description: Payment Methods & Limits like sepa, card, wire etc.
            url: >-
              https://docs.rampnow.io/quickstart/resources/payment-methods#payment-methods
          type: string
        srcAmount:
          description: Quoted source amount (equals input if `srcAmount` was supplied)
          type: string
        srcChain:
          description: >-
            Echoes the source chain


            Supported Blockchains like ethereum, bitcoin etc. For additional
            options, see the [full list](/quickstart/resources/blockchain-list).
          externalDocs:
            description: Supported Blockchains like ethereum, bitcoin etc.
            url: https://docs.rampnow.io/quickstart/resources/blockchain-list
          type: string
        srcCurrency:
          description: >-
            Echoes the source currency


            Supported Crypto Currencies like EUR, USDT etc. For additional
            options, see the [full
            list](/quickstart/resources/supported-assets).
          externalDocs:
            description: Supported Crypto Currencies like EUR, USDT etc.
            url: https://docs.rampnow.io/quickstart/resources/supported-assets
          type: string
      required:
        - orderType
        - srcCurrency
        - srcChain
        - srcAmount
        - dstCurrency
        - dstChain
        - dstAmount
        - paymentMode
        - exchangeRate
        - feeDetails
        - message
      type: object
    OrderType:
      enum:
        - unknown
        - buy
        - sell
        - swap
        - payment
        - refill
        - payout
        - cross_border
        - payroll
        - sendout
        - escrow
      type: string
    FeeDetail:
      description: >-
        FeeDetail describes one line item in an order's fee breakdown. Fees are
        already reflected in the

        order's `srcAmount` / `dstAmount`; this struct is exposed purely so
        partners can render an

        itemised breakdown.
      properties:
        currency:
          description: >-
            Currency the `fee` amount is denominated in


            Supported Crypto Currencies like EUR, USDT etc. For additional
            options, see the [full
            list](/quickstart/resources/supported-assets).
          externalDocs:
            description: Supported Crypto Currencies like EUR, USDT etc.
            url: https://docs.rampnow.io/quickstart/resources/supported-assets
          type: string
        discount:
          $ref: '#/components/schemas/Discount'
          description: Discount rule applied to this fee, if any
        discountValue:
          description: Absolute amount subtracted by `discount`, in `currency`
          type: string
        fee:
          description: Fee amount in `currency`, already net of any discount
          type: string
        isInclusive:
          description: >-
            IsInclusive is informational only. When true, this fee is already
            netted inside the order's

            srcAmount / dstAmount and is not billed again; when false, it was
            added on top of the base

            amount. Partners generally do not need to act on this flag — it is
            exposed for accurate

            fee-breakdown display and reconciliation.
          type: boolean
        slippage:
          description: >-
            Slippage tolerance for provider-side conversion, as a fraction (e.g.
            0.01 = 1%)
          type: number
        type:
          description: >-
            Fee category (e.g. `rampnow`, `partner`, `network`, `platform`,
            exchange fees)
          type: string
      required:
        - type
        - fee
        - currency
        - isInclusive
      type: object
    Discount:
      properties:
        type:
          description: 'Discount kind: `percentage` or `flat`'
          type: string
        value:
          description: >-
            Discount magnitude (percent 0-100 when `type=percentage`, or a flat
            amount in the parent fee's currency)
          type: string
      required:
        - type
        - value
      type: object
  securitySchemes:
    apiKeyAuth:
      description: >-
        Partner API key sent in the X-RAMPNOW-API-KEY header. Every request must
        ALSO send X-RAMPNOW-TIMESTAMP (unix seconds) and X-RAMPNOW-SIGN (hex
        HMAC-SHA256 of `timestamp + METHOD + requestURI + rawBody`, keyed with
        your API secret). See the Authentication guide.
      in: header
      name: X-RAMPNOW-API-KEY
      type: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.