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

# Get AugustusRFQ order by hash

> Fetch a single AugustusRFQ order by its hash, with current state and remaining fillable balance.

Fetch one order by the `orderHash` returned when it was posted. The response is the full order record, including its current `state` and the `fillableBalance` still open for partial fills.

<Tip>
  Always re-check `expiry` against the current block and confirm `state` is `PENDING` before a taker submits a fill. The on-chain fill reverts if the order is expired, already `FULFILLED`, or `CANCELLED`.
</Tip>

## Related pages

<CardGroup cols={2}>
  <Card title="OTC overview" icon="handshake" href="/api-reference/rfq/overview">
    Lifecycle, endpoints, and order states end to end.
  </Card>

  <Card title="List maker orders" icon="list" href="/api-reference/rfq/orders-list-maker">
    All orders created by a maker, paginated.
  </Card>

  <Card title="List taker orders" icon="list-check" href="/api-reference/rfq/orders-list-taker">
    All orders a given taker can fill.
  </Card>

  <Card title="SDK → OTC" icon="code" href="/sdk/products/otc">
    `sdk.otcOrders.getOTCOrders` reads orders by maker or taker.
  </Card>
</CardGroup>


## OpenAPI

````yaml api-reference/specs/rfq.json GET /ft/order/{orderHash}
openapi: 3.0.3
info:
  title: Velora OTC API (AugustusRFQ)
  version: 1.0.0
  description: >-
    Velora OTC API — post and read signed AugustusRFQ orders for fungible-token
    over-the-counter settlement. Filling and cancelling are on-chain calls to
    the AugustusRFQ contract, not REST operations.
servers:
  - url: https://api.velora.xyz
    description: Production
security: []
externalDocs:
  description: OTC API — overview and integration guide.
  url: https://velora.xyz/docs/api-reference/rfq/overview
paths:
  /ft/order/{orderHash}:
    get:
      summary: Get an OTC order by hash
      description: >-
        Fetch a single order by its `orderHash`, including its current `state`
        and remaining `fillableBalance`.
      operationId: rfqGetOrder
      parameters:
        - name: orderHash
          in: path
          required: true
          schema:
            type: string
          example: 0x9d8f...c1a2
          description: The order's EIP-712 hash, returned when the order was posted.
      responses:
        '200':
          description: The order record.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RfqOrderRecord'
        '404':
          description: No order with that hash.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    RfqOrderRecord:
      type: object
      description: >-
        A stored order as returned by the API, including server-tracked balances
        and state.
      properties:
        orderHash:
          type: string
          description: The order's EIP-712 hash — its unique identifier.
        chainId:
          $ref: '#/components/schemas/ChainId'
        nonceAndMeta:
          type: string
        expiry:
          type: integer
        maker:
          $ref: '#/components/schemas/Address'
        taker:
          $ref: '#/components/schemas/Address'
        makerAsset:
          $ref: '#/components/schemas/Address'
        takerAsset:
          $ref: '#/components/schemas/Address'
        makerAmount:
          $ref: '#/components/schemas/TokenAmount'
        takerAmount:
          $ref: '#/components/schemas/TokenAmount'
        signature:
          type: string
        permitMakerAsset:
          type: string
          nullable: true
        state:
          $ref: '#/components/schemas/OrderState'
        type:
          $ref: '#/components/schemas/OrderType'
        takerFromMeta:
          allOf:
            - $ref: '#/components/schemas/Address'
          description: Intended receiver decoded from `nonceAndMeta`.
        makerBalance:
          allOf:
            - $ref: '#/components/schemas/TokenAmount'
          description: >-
            Min of the maker's balance, allowance, and balance backing this
            order.
        fillableBalance:
          allOf:
            - $ref: '#/components/schemas/TokenAmount'
          description: Remaining unfilled `makerAmount`.
        reservedBalance:
          allOf:
            - $ref: '#/components/schemas/TokenAmount'
          description: Amount currently reserved by this order.
        swappableBalance:
          allOf:
            - $ref: '#/components/schemas/TokenAmount'
          description: Amount available to fill right now.
        transactionHash:
          type: string
          nullable: true
          description: Fill or cancellation transaction hash, once settled on-chain.
        createdAt:
          type: integer
          description: Unix timestamp the order was created.
        updatedAt:
          type: integer
          description: Unix timestamp the order was last updated.
    ErrorResponse:
      type: object
      description: Standard Velora error envelope.
      required:
        - errorType
      properties:
        errorType:
          $ref: '#/components/schemas/ErrorCode'
        details:
          type: string
          description: Human-readable description of the failure.
      example:
        errorType: InvalidSignature
        details: Order signature does not recover to maker
    ChainId:
      type: integer
      description: >-
        EVM chain ID. AugustusRFQ is deployed on 1 (Mainnet), 10 (Optimism), 56
        (BSC), 137 (Polygon), 8453 (Base), 42161 (Arbitrum), 43114 (Avalanche),
        and 100 (Gnosis). See /resources/chains-and-contracts for per-chain
        addresses.
      example: 1
    Address:
      type: string
      description: EVM address (20 bytes, hex-encoded with `0x` prefix).
      pattern: ^0x[a-fA-F0-9]{40}$
      example: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
    TokenAmount:
      type: string
      description: >-
        Token amount in raw units / wei (no decimal point). Serialized as a
        string to preserve precision beyond JavaScript Number range.
      example: '1000000000000000000'
    OrderState:
      type: string
      enum:
        - DRAFT
        - PENDING
        - FULFILLED
        - CANCELLED
        - SUSPENDED
        - EXPIRED
      description: >-
        Lifecycle state. `SUSPENDED` means the maker's balance or allowance
        dropped below the order. `FULFILLED` means fully filled.
    OrderType:
      type: string
      enum:
        - P2P
        - LIMIT
      description: >-
        `P2P` is a counterparty-restricted OTC order (a named `taker`). `LIMIT`
        is an open AugustusRFQ order. The OTC API surface is `P2P`.
    ErrorCode:
      type: string
      description: >-
        Documented Velora error code (e.g. `InvalidSignature`, `InvalidInput`,
        `UnsupportedChain`). The set is open — handle codes you recognize and
        fall back to a generic path otherwise. See
        /api-reference/troubleshooting.
      example: InvalidSignature

````