For AI agents: the complete documentation index is available at /es/llms.txt, the full documentation bundle is available at /es/llms-full.txt, and this page is available as Markdown at /es/api/exchange-rates/get-v1-exchange-rate.md.
  • Español

    • Obtener tasa de cambio

    Generado a partir de la especificación OpenAPI de Finity.

    URL basehttps://api.finity.com.co

    Tasas de cambio

    GET/v1/rates

    Get exchange rate using rate observations

    Returns a rate using the new rate-observations flow when the enable_v2_exchange_rate feature flag is enabled for the authenticated user. Observation validity is 8 seconds.

    Requiere token Bearer

    Solicitud

    NombreUbicaciónTipoRequeridoEjemplo
    fromqueryUSD | COPSíUSD
    toqueryCOP | USDSíCOP

    Respuestas

    200The exchange rate has been successfully retrieved.
    id: string
from_currency: string
to_currency: string
rate: number
expires_at: string (date-time)
valid_for_seconds: integer
    400Unsupported currency pair or missing parameters.
    500No valid rate observation is available.

    Probar en vivo

    Live request

    Try this endpoint

    Configure the request and send it directly to the Finity API.

    GET
    Code language

    Authentication

    Use a Bearer token to authorize this request.

    Optional

    Parameters

    Provide the values required by this endpoint.

    Request URLProduction
    GEThttps://api.finity.com.co/v1/rates?from=USD&to=COP
    Generated Shell requestReady to copy
    curl -X GET \
  'https://api.finity.com.co/v1/rates?from=USD&to=COP' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json'