> ## Documentation Index > Fetch the complete documentation index at: https://docs.ripio.com/llms.txt > Use this file to discover all available pages before exploring further. # Create Quote > Obtains a held price quote for a cryptocurrency conversion, valid for a limited time (e.g., 30 seconds). This quote includes the exchange rate and applicable fees, serving as the basis for on-ramp and off-ramp operations. ## OpenAPI ````yaml ramps-api/openapi.json POST /api/v1/quotes/ openapi: 3.1.0 info: title: Ripio Ramp API version: v1 description: >- API for Ripio ramp services, enabling partners to integrate On-Ramp, Off-Ramp, customer management, KYC processes, and other financial functionalities. This API is RESTful, uses JSON for requests and responses, and standard HTTP status codes. This document is based on the 'onramp-api.pdf' provided and aims to be compliant with OpenAPI Specification v3.1.0. The PDF indicates that the API documentation is a draft and subject to change. servers: - url: https://skala-sandbox.ripio.com description: Sandbox environment - url: https://skala.ripio.com description: Production environment security: - BearerToken: [] tags: - name: Authentication description: Operations related to API authentication and authorization. - name: Support Tickets description: >- Operations for raising and tracking customer support tickets with Ripio's support team. This feature must be enabled for your account by the Ripio team. - name: Customers description: Operations related to customer management. - name: KYC description: Operations related to Know Your Customer processes. - name: Fiat Accounts description: Operations related to managing fiat accounts and their requirements. - name: Quotes description: Operations related to obtaining and managing conversion quotes. - name: On-Ramp description: Operations related to fiat-to-crypto (on-ramp) processes. - name: Off-Ramp description: Operations related to crypto-to-fiat (off-ramp) processes. - name: Transactions description: Operations related to listing and managing all transaction types. - name: Networks description: >- Operations related to retrieving available deposit and withdrawal networks. - name: Rates description: Operations related to retrieving market rates. - name: Transaction Limits description: >- Operations related to retrieving per-transaction limits by currency and ramp operation. - name: Sandbox description: Operations specific to the sandbox environment for testing purposes. - name: Webhooks description: Webhook event notifications from Ripio Ramp API. - name: Sell and Pay description: >- Endpoints for managing Sell and Pay transactions, which allow customers to convert cryptocurrency to fiat currency and pay merchants via QR codes paths: /api/v1/quotes/: post: tags: - Quotes summary: Create Quote description: >- Obtains a held price quote for a cryptocurrency conversion, valid for a limited time (e.g., 30 seconds). This quote includes the exchange rate and applicable fees, serving as the basis for on-ramp and off-ramp operations. operationId: createQuote requestBody: required: true description: Details for the quote request. content: application/json: schema: $ref: '#/components/schemas/QuoteCreationRequest' responses: '201': description: Quote created successfully. content: application/json: schema: $ref: '#/components/schemas/QuoteResponse' '400': description: >- Bad Request - e.g., invalid currency pair, amount, or other parameters. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized - Invalid or missing access token. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 40001 type: NotAuthenticated detail: message: Authentication credentials were not provided. code: not_authenticated status: 401 components: schemas: QuoteCreationRequest: type: object properties: fromCurrency: type: string description: The source currency for the conversion. example: ARS toCurrency: type: string description: The target currency for the conversion. example: USDC fromAmount: type: string description: The amount of the source currency to be converted. example: '1500' chain: type: string description: >- The blockchain network to be used for the conversion (applicable for certain cryptocurrencies). example: ETHEREUM_SEPOLIA paymentMethodType: type: string description: >- The desired payment method for the conversion (e.g., `bank_transfer`, `breb`, `r2p_bancolombia`, `r2p_nequi`). Note: `breb`, `r2p_bancolombia` and `r2p_nequi` are only available for Colombia. Additionally, `r2p_bancolombia` and `r2p_nequi` are only available for on-ramp operations. example: bank_transfer required: - fromCurrency - toCurrency - fromAmount - chain - paymentMethodType QuoteResponse: type: object properties: quoteId: type: string format: uuid description: Unique identifier for the quote. example: 8142b065-79c4-4f48-9e33-11b17bc658d4 fromCurrency: type: string description: The source currency for the conversion. example: ARS toCurrency: type: string description: The target currency for the conversion. example: USDC fromAmount: type: string description: The amount of the source currency to be converted. example: '1500.00000000' finalFromAmount: type: string description: The amount of the source currency after fees deduction. example: '1400.00000000' toAmount: type: string description: The amount of the target currency received after the conversion. example: '1.42857143' finalToAmount: type: string description: The amount of the target currency after fees deduction. example: '1.32857143' rate: type: string description: The exchange rate applied for the conversion. example: '1050.00000000' expiration: type: string format: date-time description: The date and time when the quote expires (UTC). example: '2024-04-10T18:17:07.702533Z' fees: type: array items: $ref: '#/components/schemas/Fee' required: - quoteId - fromCurrency - toCurrency - fromAmount - finalFromAmount - toAmount - finalToAmount - rate - expiration - fees ErrorResponse: type: object properties: code: type: integer description: Application-specific error code. type: type: string description: Type of error or exception. detail: type: object properties: message: type: string description: Detailed error message. additionalProperties: true status: type: integer description: HTTP status code. required: - code - type - detail - status Fee: type: object properties: amount: type: string description: The amount of the fee. example: '0.37' type: type: string description: The type of fee (e.g., Network Fee). example: Gas Price currency: type: string description: The currency in which the fee amount is expressed. example: ARS appliesOnFromAmount: type: boolean description: >- Indicates whether it deducts the amount on the fromAmount or not. Always the negation of appliesOnToAmount. appliesOnToAmount: type: boolean description: >- Indicates whether it deducts the amount on the toAmount or not. Always the negation of appliesOnFromAmount. required: - amount - type - currency - appliesOnFromAmount - appliesOnToAmount securitySchemes: BearerToken: type: http scheme: bearer bearerFormat: JWT description: >- Access token obtained via [/oauth2/token/](/ramps-api/authentication/acquire-access-token). Use as `Authorization: Bearer `. ````