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

# List taker OTC orders

> List the OTC orders addressed to a taker: the orders that account can fill. Paginated.

List orders where `account` is the named taker: the orders that address is allowed to fill. Use `type=P2P` to scope to counterparty-restricted OTC orders. Paginated with `limit` and `offset`; `total` / `hasMore` mark the end.

This is the endpoint a taker polls to discover orders a maker has addressed to them.

## 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">
    The mirror endpoint: orders created by a maker.
  </Card>

  <Card title="GET /ft/order/:orderHash" icon="magnifying-glass" href="/api-reference/rfq/orders-get-by-hash">
    Fetch a single order by hash before filling.
  </Card>

  <Card title="SDK → OTC" icon="code" href="/sdk/products/otc">
    `sdk.otcOrders.getOTCOrders({ taker })`.
  </Card>
</CardGroup>


## OpenAPI

````yaml api-reference/specs/rfq.json GET /ft/p2p/{chainId}/taker/{account}
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/p2p/{chainId}/taker/{account}:
    get:
      summary: List orders addressed to a taker
      description: >-
        List orders where `account` is the named taker — the orders that address
        can fill. Paginated. Filter to OTC orders with `type=P2P`.
      operationId: rfqListTakerOrders
      parameters:
        - name: chainId
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/ChainId'
          description: EVM chain ID.
        - name: account
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/Address'
          description: The taker's wallet address.
        - name: type
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/OrderType'
          example: P2P
          description: Filter by order type. Use `P2P` for OTC orders.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 100
          description: Maximum number of orders to return.
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            default: 0
          description: Number of orders to skip, for pagination.
        - name: orderBy
          in: query
          required: false
          schema:
            type: string
            enum:
              - createdAt
              - updatedAt
              - expiry
            default: createdAt
          description: Field to sort by.
        - name: hideSmallBalances
          in: query
          required: false
          schema:
            type: boolean
            default: false
          description: Omit orders whose remaining fillable balance is negligible.
      responses:
        '200':
          description: Paginated list of orders.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RfqOrdersListResponse'
components:
  schemas:
    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'
    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`.
    RfqOrdersListResponse:
      type: object
      description: Paginated list of orders.
      properties:
        orders:
          type: array
          items:
            $ref: '#/components/schemas/RfqOrderRecord'
        limit:
          type: integer
        offset:
          type: integer
        total:
          type: integer
        hasMore:
          type: boolean
    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.
    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.

````