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

# Get the exchange rate between two currencies

> Returns the current exchange rate between two currencies, for example USD to GBP. Multiply an amount in the from currency by rate to convert it to the to currency. Returns 503 when no rate is available.

Operation ID: get__fx_rate.



## OpenAPI

````yaml /openapi/itoflow-public.openapi.json get /fx-rate
openapi: 3.1.0
info:
  description: >-
    All Itoflow APIs are experimental and may change without notice. Read-only
    operations marked interactive can be tried from the documentation; the
    others are reference-only.
  title: Itoflow Developer API
  version: 1.0.0
servers:
  - description: Itoflow API
    url: https://api.itoflow.ai
security: []
tags:
  - name: Account
  - name: Billing
  - name: Brokers
  - name: Chat
  - name: Connected MCP servers
  - name: GitHub
  - name: Market data
  - name: Monitors
  - name: Notifications
  - name: Portfolios
  - name: Risk runs
  - name: Sharing and data
  - name: Strategies
paths:
  /fx-rate:
    get:
      tags:
        - Market data
      summary: Get the exchange rate between two currencies
      description: >-
        Returns the current exchange rate between two currencies, for example
        USD to GBP. Multiply an amount in the from currency by rate to convert
        it to the to currency. Returns 503 when no rate is available.


        Operation ID: get__fx_rate.
      operationId: get__fx_rate
      parameters:
        - description: Currency to convert from, as a 3-letter upper-case ISO 4217 code.
          in: query
          name: from
          required: true
          schema:
            description: Currency to convert from, as a 3-letter upper-case ISO 4217 code.
            example: USD
            type: string
        - description: Currency to convert to, as a 3-letter upper-case ISO 4217 code.
          in: query
          name: to
          required: true
          schema:
            description: Currency to convert to, as a 3-letter upper-case ISO 4217 code.
            example: GBP
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FxRateResponse'
          description: Get the exchange rate between two currencies
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Bad request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Authentication required
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Not found
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Server error
      security: []
components:
  schemas:
    FxRateResponse:
      additionalProperties: {}
      properties:
        error:
          type: string
        message:
          type: string
        ok:
          type: boolean
        status:
          type: string
        success:
          type: boolean
      type: object
    Error:
      properties:
        available:
          description: Optional available amount or value
          type: string
        billing_action:
          $ref: '#/components/schemas/BillingAction'
        code:
          description: Machine-readable error code
          type: string
        currentVersion:
          description: Current server-side version, when relevant
          type: number
        details:
          description: Optional structured error details
        error:
          description: Error type or code
          type: string
        expectedVersion:
          description: Client-provided expected version, when relevant
          type: number
        message:
          description: Human-readable error message
          type: string
        requested:
          description: Optional requested amount or value
          type: string
        usage:
          description: Optional usage metadata for limit errors
      required:
        - error
      type: object
    BillingAction:
      description: Action that resolves a billing-related rejection
      properties:
        href:
          type: string
        kind:
          enum:
            - upgrade
            - payment_method
            - spending_cap
            - billing
          type: string
        label:
          type: string
      required:
        - href
        - label
        - kind
      type: object

````

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