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

# Get RFQ

> Retrieve the current state of a request for quote

Returns the current state of an RFQ, including its status and expiry. Statuses progress from `OPEN` to a terminal state of `FILLED`, `CANCELLED`, or `EXPIRED`.

## Authentication

Requires an instance API key with the `trading` service enabled.

## Path Parameters

<ParamField path="id" type="string" required>
  The RFQ identifier. Max 100 characters.
</ParamField>

<RequestExample>
  ```bash theme={null}
  curl -X GET "https://api.trusset.org/orderbooks/stocks/api/rfq/rfq_abc123" \
    -H "x-api-key: trusset_{instanceRef}_{secret}"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "id": "rfq_abc123",
      "requesterAddress": "0x1111111111111111111111111111111111111111",
      "baseToken": "0x1234567890abcdef1234567890abcdef12345678",
      "quoteToken": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "side": "BUY",
      "baseAmount": "5000000000000000000",
      "status": "OPEN",
      "quoteCount": 3,
      "expiresAt": "2025-01-15T10:30:15.000Z",
      "createdAt": "2025-01-15T10:30:00.000Z"
    },
    "metadata": {
      "requestId": "550e8400-e29b-41d4-a716-446655440000",
      "timestamp": "2025-01-15T10:30:05.000Z",
      "instanceId": "inst_abc"
    }
  }
  ```
</ResponseExample>

## Error Codes

| Code            | Status | Description                                |
| --------------- | ------ | ------------------------------------------ |
| `NOT_FOUND`     | 404    | No RFQ found with this ID in your instance |
| `INVALID_PARAM` | 400    | Invalid RFQ identifier                     |