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

# Quote

> Request an early settlement quote for an existing hedge.



## OpenAPI

````yaml POST /customers/{customerId}/hedges/{hedgeId}/early-settlement/quote
openapi: 3.1.0
info:
  title: Grain API
  version: 1.0.0
  description: >-
    Grain's API provides a comprehensive set of endpoints for managing hedging,
    spot transactions, pricing, and fund movements - enabling seamless
    integration of FX workflows into your platform. Each API call follows REST
    conventions, uses secure authentication, and returns standardized responses
    for consistency across environments.
  license:
    name: Creative Commons Attribution 3.0
  contact:
    name: Grain Finance
    url: https://docs.grainfinance.co
    email: support@grainfinance.co
  termsOfService: https://grainfinance.co/terms-of-service/
  x-apiClientRegistration:
    url: https://grainfinance.co/partners
servers:
  - url: https://api.grainfinance.co/v1
    description: Grain API
security: []
tags:
  - name: Hedges
    description: >-
      Hedge objects represent transactions that lock exchange rates for future
      dates. A single hedge locks an exchange rate for a future transaction
      between two currencies.
  - name: Dual Hedges
    description: >-
      A dual hedge mitigates FX risk by automatically generating two linked
      hedge legs - a customer leg and a supplier leg - both routed through the
      customer's functional currency. This structure reduces exposure to
      currency fluctuations for both cash flow and accounting purposes, while
      allowing independent tracking and reporting of each hedge leg.
  - name: Customers
    description: >-
      Customer objects represent your end customers on the Grain platform. A
      customer must be created before a hedge or spot transaction can be
      initiated.
  - name: Pricing
    description: >-
      Pricing endpoints provide access to FX rates for currency pairs that are
      not being hedged. These endpoints can be used for live rate display or
      bulk retrieval to support high-volume quoting workflows.
  - name: Spots
    description: >-
      Spot objects represent currency conversions executed for immediate or
      near-term settlement.
  - name: Conversions
    description: >-
      Conversion objects represent currency conversions executed for immediate
      or near-term settlement.
  - name: Wallets
    description: Endpoints to view balances, manage funding, and perform transfers.
paths:
  /customers/{customerId}/hedges/{hedgeId}/early-settlement/quote:
    post:
      tags:
        - Hedges
      description: Request an early settlement quote for an existing hedge.
      operationId: Early Settlement Quote
      parameters:
        - description: The id of the customer within the Grain platform.
          in: path
          name: customerId
          required: true
          schema:
            type: string
        - description: The id of the hedge within the Grain platform.
          in: path
          name: hedgeId
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Early Settlement Proposal Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EarlySettlementQuoteResponse'
        '404':
          description: The request failed because the resource does not exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: The request failed because a business rule constraint was violated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '412':
          description: The request failed because one or more preconditions were not met.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - api-key: []
components:
  schemas:
    EarlySettlementQuoteResponse:
      description: The response when requesting an early settlement quote for a hedge.
      properties:
        id:
          type: string
          description: The unique identifier of the early settlement proposal.
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        hedgeId:
          type: string
          description: The unique identifier of the hedge associated with this proposal.
          example: 8173b9a7-ee61-413e-b9e3-7c04b2a067c5
        toCurrencyAmount:
          type: number
          format: double
          description: The amount in the target currency (toCurrency).
          example: 10000
        fromCurrencyAmount:
          type: number
          format: double
          description: The amount in the source currency (fromCurrency).
          example: 10825
        quote:
          type: number
          format: double
          description: The exchange rate quote for the early settlement.
          example: 1.0825
        validUntilTs:
          type: number
          format: double
          description: >-
            The unix timestamp until which the early settlement proposal is
            valid.
          example: 1710510600
      required:
        - id
        - hedgeId
        - toCurrencyAmount
        - fromCurrencyAmount
        - quote
        - validUntilTs
      type: object
      additionalProperties: false
    ErrorResponse:
      description: An API Error
      properties:
        message:
          type: string
          description: A short explanation of the error.
          example: Can't perform this action
        reason:
          type: string
          description: A detailed description of the reason for the failure.
          example: >-
            Supplied object is in *Cancelled* state, which prevents performing
            this action
      required:
        - message
      type: object
      additionalProperties: false
  securitySchemes:
    api-key:
      type: http
      scheme: basic
      description: >-
        Basic authentication using the partner API keys from
        https://console.grainfinance.co/keys

````