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

# Get Forex Real-Time Data

> [OpenAPI JSON Spec](/docs/output/v1_macro_forex_real-time_get.json)
Retrieve real-time data for a specified forex currency pair. Returns simplified data with symbol, date, and price (close price).

**Response Data Structure**

- `data` (RealTimeData): Real-time forex data

**RealTimeData fields:**
- `symbol` (string): Forex symbol (e.g., "EURUSD", "GBPJPY")
- `date` (string): Quote time as an RFC3339 UTC timestamp, e.g. "2026-08-04T13:26:49Z" — the same convention as `time_period_start` on the kline endpoints. When FMP has no live quote and the prior session's stored close is served instead, the date is that session's day at "2026-08-03T00:00:00Z" — a 00:00:00 time identifies the session, it is not the moment the market closed.
- `price` (float): Latest quoted price

**Note:** The price is the latest available quote. When the market is closed it is the last quote of the prior session; some feeds are delayed at source (see the quote time). When FMP has no quote for the symbol, the API returns an empty data structure with default values: `{"symbol": "", "date": "", "price": 0}`.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/macro/forex/real-time
openapi: 3.0.0
info:
  contact: {}
  description: >-
    Welcome to Arrays!


    Arrays is a unified financial data layer for both financial institutions and
    retail users, delivering comprehensive market data across crypto and equity
    markets. Our datasets cover fundamentals, ETFs, options, crypto, and more.


    Visit [arrays.org](https://arrays.org) to request an API key and start your
    free trial. You can explore our full API offerings in the documentation
    below.


    For any questions regarding APIs or pricing, please contact
    support@arrays.org.
  title: Arrays API
  version: '1.0'
servers:
  - url: https://data-tools.prd.arrays.org/api
security: []
paths:
  /v1/macro/forex/real-time:
    get:
      tags:
        - Macro
      summary: Get Forex Real-Time Data
      description: >-
        [OpenAPI JSON Spec](/docs/output/v1_macro_forex_real-time_get.json)

        Retrieve real-time data for a specified forex currency pair. Returns
        simplified data with symbol, date, and price (close price).


        **Response Data Structure**


        - `data` (RealTimeData): Real-time forex data


        **RealTimeData fields:**

        - `symbol` (string): Forex symbol (e.g., "EURUSD", "GBPJPY")

        - `date` (string): Quote time as an RFC3339 UTC timestamp, e.g.
        "2026-08-04T13:26:49Z" — the same convention as `time_period_start` on
        the kline endpoints. When FMP has no live quote and the prior session's
        stored close is served instead, the date is that session's day at
        "2026-08-03T00:00:00Z" — a 00:00:00 time identifies the session, it is
        not the moment the market closed.

        - `price` (float): Latest quoted price


        **Note:** The price is the latest available quote. When the market is
        closed it is the last quote of the prior session; some feeds are delayed
        at source (see the quote time). When FMP has no quote for the symbol,
        the API returns an empty data structure with default values: `{"symbol":
        "", "date": "", "price": 0}`.
      parameters:
        - description: Forex symbol (e.g., EURUSD, GBPJPY)
          in: query
          name: symbol
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successfully retrieved forex real-time data
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      data:
                        items:
                          $ref: '#/components/schemas/model.RealTimeData'
                        type: array
                    type: object
        '400':
          description: Invalid parameters
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      data:
                        $ref: '#/components/schemas/model.APIError'
                    type: object
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      data:
                        $ref: '#/components/schemas/model.APIError'
                    type: object
      security:
        - ApiKeyAuth: []
components:
  schemas:
    model.APIResponse:
      properties:
        data: {}
        error:
          $ref: '#/components/schemas/model.APIError'
        metadata: {}
        pagination: {}
        request_id:
          type: string
        success:
          type: boolean
      type: object
    model.RealTimeData:
      properties:
        date:
          description: >-
            Date is an RFC3339 UTC timestamp (same convention as the kline
            time_period_start fields); empty string when no quote is available.
            See the handler docs for the stored-close fallback case.
          example: '2026-08-04T13:26:49Z'
          type: string
        price:
          example: 4756.5
          type: number
        symbol:
          example: ^SPX
          type: string
      type: object
    model.APIError:
      properties:
        code:
          example: RESOURCE_NOT_FOUND
          type: string
        details:
          items:
            $ref: '#/components/schemas/model.APIErrorDetail'
          type: array
        docs_url:
          type: string
        examples:
          items:
            type: string
          type: array
        hint:
          type: string
        message:
          example: The requested resource was not found.
          type: string
        suggestions:
          items:
            type: string
          type: array
      type: object
    model.APIErrorDetail:
      properties:
        field:
          type: string
        got:
          type: string
        reason:
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: 'API Key authentication. Example: "your-api-key-here"'
      in: header
      name: X-API-Key
      type: apiKey

````