---
updatedAt: 2026-04-26T18:58:54.000Z
agentTools:
  projectIndex: https://docs.kyan.blue/llms.txt
---

# Submit RFQ response

Submit a response to a Request for Quote (RFQ) with your pricing.

Makers use this endpoint to provide pricing for RFQ requests they've received. The response structure uses a nested array format where each order is represented as a pair of elements.

**Response Structure:**
The `fills` array structure mirrors the RFQ request structure with two categories:
- **Basket of options response pairs only**: Up to 6 option response pairs
- **Single perpetual response pair only**: Exactly 1 perpetual response pair

Each response pair consists of:
1. **First element**: A copy of the original RFQ request parameters (instrument_name, contracts, direction)
2. **Second element**: The complete signed order with pricing and all execution details

**Critical Requirements (MUST follow to avoid errors):**
- **Order type MUST be `good_til_cancelled` (GTC)** - Using `good_til_date` (GTD) will cause validation errors
- **`post_only` MUST be `true`** - Setting to `false` will cause validation errors for RFQ responses

**Important Validation Rules:**
- All orders from the original RFQ request must be included in the response
- For each pair, the parameters in the first element must match those in the second element:
  - `instrument_name` must be identical
  - `direction` must be OPPOSITE (if request is "buy", response must be "sell" and vice versa)
  - `contracts` must be identical (perpetual RFQ legs use `contracts`, not the legacy `amount`)
- The `taker` address must match across all locations (root level and in signed orders)
- The `maker` address must be consistent across all signed orders
- All signatures must be valid EIP-712 signatures and not expired

**Key Fields in Signed Orders (second element of each pair):**
- `price`: Your quoted price for this order
- `type`: **MUST be "good_til_cancelled"** (GTD not supported for RFQ)
- `post_only`: **MUST be true** (false will cause errors)
- `signature`: Valid EIP-712 signature for the order
- `signature_deadline`: Unix timestamp when the signature expires
- `taker` and `maker`: Must match the root-level addresses

**Note:** RFQ responses can be cancelled using the DELETE /orders endpoint with the order_id from this response.


# OpenAPI definition

````json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Premia V4 Public API",
    "description": "Public API for the Premia V4 platform providing traders and developers with programmatic access to options and perpetual futures trading.\nThis comprehensive API enables you to access market data, manage accounts, execute trades, and analyze portfolio risk with appropriate authentication.\n\n## Key Identifier Types\nThe API uses two primary identifier types throughout the trading system:\n- **order_id**: Unique identifier for individual limit orders. Generated as a 32-character hexadecimal string when a limit order is posted to the orderbook. Used for order management operations such as cancellation and status tracking.\n- **trade_id**: Unique identifier for executed trades. Generated as a 32-character hexadecimal string when a market order is filled against limit orders. Used for trade history tracking and settlement records.\n**Relationship**: Multiple trades can reference the same order_id when a single limit order is filled across multiple market orders (partial fills). Each trade execution generates a unique trade_id.\n\nThis document is organized following standard categories to help you integrate with the platform:\n1. Authentication/Session Management - API authentication methods and one-click trading sessions\n2. Market Data - Access real-time information about available instruments and market state\n3. Trading - Execute trades, place orders, and manage your positions \n4. Block RFQ - Request for Quote functionality for larger or custom trades\n5. Wallet - Deposit, withdraw, and transfer funds\n6. Account Management - Manage your trading account and view risk metrics\n",
    "version": "1.0.0",
    "contact": {
      "name": "Premia API Team",
      "url": "https://premia.io"
    },
    "license": {
      "name": "Proprietary",
      "url": "https://premia.io/license"
    }
  },
  "servers": [
    {
      "url": "https://sandbox.kyan.sh",
      "description": "Sandbox server (REST API)"
    },
    {
      "url": "https://staging.kyan.sh",
      "description": "Staging server (REST API)"
    }
  ],
  "security": [
    {
      "ApiKeyAuth": []
    }
  ],
  "tags": [
    {
      "name": "Block RFQ",
      "description": "Request for Quote operations for large or custom trades"
    }
  ],
  "externalDocs": {
    "description": "Complete API Documentation",
    "url": "https://docs.kyan.blue/reference"
  },
  "paths": {
    "/rfq/response": {
      "post": {
        "tags": [
          "Block RFQ"
        ],
        "summary": "Submit RFQ response",
        "description": "Submit a response to a Request for Quote (RFQ) with your pricing.\n\nMakers use this endpoint to provide pricing for RFQ requests they've received. The response structure uses a nested array format where each order is represented as a pair of elements.\n\n**Response Structure:**\nThe `fills` array structure mirrors the RFQ request structure with two categories:\n- **Basket of options response pairs only**: Up to 6 option response pairs\n- **Single perpetual response pair only**: Exactly 1 perpetual response pair\n\nEach response pair consists of:\n1. **First element**: A copy of the original RFQ request parameters (instrument_name, contracts, direction)\n2. **Second element**: The complete signed order with pricing and all execution details\n\n**Critical Requirements (MUST follow to avoid errors):**\n- **Order type MUST be `good_til_cancelled` (GTC)** - Using `good_til_date` (GTD) will cause validation errors\n- **`post_only` MUST be `true`** - Setting to `false` will cause validation errors for RFQ responses\n\n**Important Validation Rules:**\n- All orders from the original RFQ request must be included in the response\n- For each pair, the parameters in the first element must match those in the second element:\n  - `instrument_name` must be identical\n  - `direction` must be OPPOSITE (if request is \"buy\", response must be \"sell\" and vice versa)\n  - `contracts` must be identical (perpetual RFQ legs use `contracts`, not the legacy `amount`)\n- The `taker` address must match across all locations (root level and in signed orders)\n- The `maker` address must be consistent across all signed orders\n- All signatures must be valid EIP-712 signatures and not expired\n\n**Key Fields in Signed Orders (second element of each pair):**\n- `price`: Your quoted price for this order\n- `type`: **MUST be \"good_til_cancelled\"** (GTD not supported for RFQ)\n- `post_only`: **MUST be true** (false will cause errors)\n- `signature`: Valid EIP-712 signature for the order\n- `signature_deadline`: Unix timestamp when the signature expires\n- `taker` and `maker`: Must match the root-level addresses\n\n**Note:** RFQ responses can be cancelled using the DELETE /orders endpoint with the order_id from this response.\n",
        "operationId": "submitRfqResponse",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RFQResponse"
              },
              "examples": {
                "btc_options_basket": {
                  "summary": "BTC options basket response",
                  "description": "Response to a BTC options basket RFQ request containing two orders:\n- Buy 25 contracts of BTC_USDC-31OCT25-130000-C\n- Sell 30 contracts of BTC_USDC-31OCT25-108000-C\n",
                  "value": {
                    "fills": [
                      [
                        {
                          "direction": "buy",
                          "instrument_name": "BTC_USDC-31OCT25-130000-C",
                          "contracts": 25
                        },
                        {
                          "direction": "sell",
                          "instrument_name": "BTC_USDC-31OCT25-130000-C",
                          "type": "good_til_cancelled",
                          "contracts": 25,
                          "price": 132500,
                          "post_only": true,
                          "mmp": false,
                          "liquidation": false,
                          "taker": "0xf1808cc5298036762329b56b261246c0b77EBb18",
                          "maker": "0x9a2f0C371820e8BE3D64efb3E814808F231880ff",
                          "signature": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
                          "signature_deadline": 1735689600
                        }
                      ],
                      [
                        {
                          "instrument_name": "BTC_USDC-31OCT25-108000-C",
                          "contracts": 30,
                          "direction": "sell"
                        },
                        {
                          "instrument_name": "BTC_USDC-31OCT25-108000-C",
                          "type": "good_til_cancelled",
                          "contracts": 30,
                          "direction": "buy",
                          "price": 150000,
                          "post_only": true,
                          "mmp": false,
                          "liquidation": false,
                          "taker": "0xf1808cc5298036762329b56b261246c0b77EBb18",
                          "maker": "0x9a2f0C371820e8BE3D64efb3E814808F231880ff",
                          "signature": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
                          "signature_deadline": 1735689600
                        }
                      ]
                    ],
                    "order_id": "863509b1a865fa3f502a9f6784122dd7",
                    "taker": "0xf1808cc5298036762329b56b261246c0b77EBb18",
                    "maker": "0x9a2f0C371820e8BE3D64efb3E814808F231880ff"
                  }
                },
                "eth_options_basket": {
                  "summary": "ETH options basket response",
                  "description": "Response to an ETH options basket RFQ request containing two orders:\n- Buy 250 contracts of ETH_USDC-31OCT25-4700-C at $30 per contract\n- Sell 300 contracts of ETH_USDC-31OCT25-5000-C at $50 per contract\n",
                  "value": {
                    "fills": [
                      [
                        {
                          "direction": "buy",
                          "instrument_name": "ETH_USDC-31OCT25-4700-C",
                          "contracts": 250
                        },
                        {
                          "direction": "sell",
                          "instrument_name": "ETH_USDC-31OCT25-4700-C",
                          "type": "good_til_cancelled",
                          "contracts": 250,
                          "price": 30000,
                          "post_only": true,
                          "mmp": false,
                          "liquidation": false,
                          "taker": "0xf1808cc5298036762329b56b261246c0b77EBb18",
                          "maker": "0x9a2f0C371820e8BE3D64efb3E814808F231880ff",
                          "signature": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
                          "signature_deadline": 1735689600
                        }
                      ],
                      [
                        {
                          "instrument_name": "ETH_USDC-31OCT25-5000-C",
                          "contracts": 300,
                          "direction": "sell"
                        },
                        {
                          "instrument_name": "ETH_USDC-31OCT25-5000-C",
                          "type": "good_til_cancelled",
                          "contracts": 300,
                          "direction": "buy",
                          "price": 50000,
                          "post_only": true,
                          "mmp": false,
                          "liquidation": false,
                          "taker": "0xf1808cc5298036762329b56b261246c0b77EBb18",
                          "maker": "0x9a2f0C371820e8BE3D64efb3E814808F231880ff",
                          "signature": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
                          "signature_deadline": 1735689600
                        }
                      ]
                    ],
                    "order_id": "2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e",
                    "taker": "0xf1808cc5298036762329b56b261246c0b77EBb18",
                    "maker": "0x9a2f0C371820e8BE3D64efb3E814808F231880ff"
                  }
                },
                "btc_perpetual": {
                  "summary": "BTC perpetual response",
                  "description": "Response to a BTC perpetual RFQ request:\n- Buy 4 contracts of BTC perpetual at $67,500 per BTC\n",
                  "value": {
                    "fills": [
                      [
                        {
                          "direction": "buy",
                          "instrument_name": "BTC_USDC-PERPETUAL",
                          "contracts": 4
                        },
                        {
                          "direction": "sell",
                          "instrument_name": "BTC_USDC-PERPETUAL",
                          "type": "good_til_cancelled",
                          "contracts": 4,
                          "price": 67500,
                          "post_only": true,
                          "mmp": false,
                          "liquidation": false,
                          "taker": "0xf1808cc5298036762329b56b261246c0b77EBb18",
                          "maker": "0x9a2f0C371820e8BE3D64efb3E814808F231880ff",
                          "signature": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
                          "signature_deadline": 1735689600
                        }
                      ]
                    ],
                    "order_id": "3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f",
                    "taker": "0xf1808cc5298036762329b56b261246c0b77EBb18",
                    "maker": "0x9a2f0C371820e8BE3D64efb3E814808F231880ff"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successfully submitted RFQ response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "string",
                  "example": "Response for quote sent"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized - missing API key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "409": {
            "description": "Conflict - an RFQ response with the same identifier already exists (`RFQ_RESPONSE_ALREADY_EXISTS`). The response data includes the conflicting `response_id`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "x-apikey",
        "description": "API key for authentication. Generate and manage your own at https://app.kyan.blue/portfolio/api"
      }
    },
    "schemas": {
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string",
            "description": "Error message",
            "example": "payload validation error"
          }
        },
        "required": [
          "error"
        ]
      },
      "RFQResponse": {
        "type": "object",
        "title": "RFQ Response",
        "description": "Response to a Request for Quote (RFQ), containing the maker's pricing for each requested order.\n\n**Structure:**\nThe response uses a nested array structure where each element in the `fills` array contains a pair:\n1. First element: The original RFQ request parameters (instrument_name, contracts, direction) - exact copy of what was requested\n2. Second element: The complete signed limit order from the market maker with pricing and execution details\n\n**Validation Rules:**\n- **CRITICAL REQUIREMENTS (will cause errors if not followed):**\n  - `type` field MUST be `\"good_til_cancelled\"` - GTD (\"good_til_date\") is NOT supported\n  - `post_only` field MUST be `true` - Setting to false will cause validation errors\n\n- Each fill pair must correspond to an order in the original RFQ request\n- **First element** (market order) must match the original request exactly:\n  - `instrument_name` (exact match)\n  - `direction` (exact match)\n  - `contracts` (exact match; RFQ legs are contracts-only for both options and perpetuals)\n\n- **Second element** (signed limit order) must provide opposite-side liquidity:\n  - `instrument_name` (must match the request)\n  - `direction` (must be OPPOSITE to request - if request is \"buy\", limit order must be \"sell\")\n  - `contracts` (must match the request size; RFQ legs are contracts-only)\n\n- **Example**: If taker requests to buy 25 BTC calls, maker must respond with a sell limit order for 25 BTC calls at their quoted price - The `taker` address in both the root object and signed orders must match the original RFQ request\n- All signed orders must include valid EIP-712 signatures from the maker\n",
        "properties": {
          "fills": {
            "oneOf": [
              {
                "title": "Basket of options response pairs only",
                "items": {
                  "$ref": "#/components/schemas/RFQResponseOptionPair"
                },
                "description": "Response to multiple options orders (up to 6) in a single RFQ request",
                "minItems": 1,
                "maxItems": 6
              },
              {
                "title": "Single perpetual response pair only",
                "items": {
                  "$ref": "#/components/schemas/RFQResponsePerpPair"
                },
                "description": "Response to exactly one perpetual order in the RFQ request",
                "minItems": 1,
                "maxItems": 1
              }
            ],
            "description": "RFQ response fills - must be either a basket of options response pairs OR a single perpetual response pair, cannot mix types",
            "x-readme": {
              "explorer-enabled": true
            }
          },
          "order_id": {
            "type": "string",
            "pattern": "^[a-fA-F0-9]{32}$",
            "description": "Unique identifier for this RFQ response",
            "example": "863509b1a865fa3f502a9f6784122dd7"
          },
          "taker": {
            "$ref": "#/components/schemas/TakerAddress",
            "description": "Taker address - must match the address from the original RFQ request"
          },
          "maker": {
            "$ref": "#/components/schemas/MakerAddress",
            "description": "Maker address submitting this response"
          }
        },
        "required": [
          "fills",
          "order_id",
          "taker",
          "maker"
        ]
      },
      "TakerAddress": {
        "type": "string",
        "pattern": "^0x[a-fA-F0-9]{40}$",
        "description": "Taker's Ethereum address in hexadecimal format",
        "example": "0xf1808cc5298036762329b56b261246c0b77EBb18"
      },
      "MakerAddress": {
        "type": "string",
        "pattern": "^0x[a-fA-F0-9]{40}$",
        "description": "Maker's Ethereum address in hexadecimal format",
        "example": "0x9a2f0C371820e8BE3D64efb3E814808F231880ff"
      },
      "RFQResponseOptionPair": {
        "type": "array",
        "title": "Options Response Pair",
        "description": "**Copy and edit the example below:**\n\nArray with exactly 2 elements: [market_order, limit_order]\n- Element 0: Market order (exact copy of original RFQ request)\n- Element 1: Signed limit order (market maker's response with OPPOSITE direction)\n\n**CRITICAL REQUIREMENTS:**\n- **`type` MUST be `\"good_til_cancelled\"`** - GTD will cause validation errors\n- **`post_only` MUST be `true`** - Setting to false will cause validation errors\n- The limit order direction must be opposite to the market order direction\n- If the taker requests \"buy\", the market maker must provide a \"sell\" limit order\n\n**Template to copy:**\n```json\n[\n  {\n    \"instrument_name\": \"BTC_USDC-31OCT25-130000-C\",\n    \"contracts\": 25,\n    \"direction\": \"buy\"\n  },\n  {\n    \"instrument_name\": \"BTC_USDC-31OCT25-130000-C\",\n    \"type\": \"good_til_cancelled\",  // MUST be \"good_til_cancelled\" - GTD not supported\n    \"contracts\": 25,\n    \"direction\": \"sell\",\n    \"price\": 132500,\n    \"post_only\": true,  // MUST be true for RFQ responses\n    \"mmp\": false,\n    \"liquidation\": false,\n    \"taker\": \"0xf1808cc5298036762329b56b261246c0b77EBb18\",\n    \"maker\": \"0x9a2f0C371820e8BE3D64efb3E814808F231880ff\",\n    \"signature\": \"0x1234...abcdef12\",\n    \"signature_deadline\": 1735689600\n  }\n]\n```\n",
        "minItems": 2,
        "maxItems": 2,
        "items": {
          "type": "object",
          "description": "Either a market order (3 fields) or limit order (all fields)"
        },
        "example": [
          {
            "instrument_name": "BTC_USDC-31OCT25-130000-C",
            "contracts": 25,
            "direction": "buy"
          },
          {
            "instrument_name": "BTC_USDC-31OCT25-130000-C",
            "type": "good_til_cancelled",
            "contracts": 25,
            "direction": "sell",
            "price": 132500,
            "post_only": true,
            "mmp": false,
            "liquidation": false,
            "taker": "0xf1808cc5298036762329b56b261246c0b77EBb18",
            "maker": "0x9a2f0C371820e8BE3D64efb3E814808F231880ff",
            "signature": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
            "signature_deadline": 1735689600
          }
        ]
      },
      "RFQResponsePerpPair": {
        "type": "array",
        "title": "Perpetual Response Pair",
        "description": "**Copy and edit the example below:**\n\nArray with exactly 2 elements: [market_order, limit_order]\n- Element 0: Market order (exact copy of original RFQ request)\n- Element 1: Signed limit order (market maker's response with OPPOSITE direction)\n\n**CRITICAL REQUIREMENTS:**\n- **`type` MUST be `\"good_til_cancelled\"`** - GTD will cause validation errors\n- **`post_only` MUST be `true`** - Setting to false will cause validation errors\n- The limit order direction must be opposite to the market order direction\n- If the taker requests \"buy\", the market maker must provide a \"sell\" limit order\n- Perpetual RFQ legs are sized in `contracts` (base contracts); the legacy notional `amount` is not accepted on RFQ\n\n**Template to copy:**\n```json\n[\n  {\n    \"instrument_name\": \"BTC_USDC-PERPETUAL\",\n    \"contracts\": 4,\n    \"direction\": \"buy\"\n  },\n  {\n    \"instrument_name\": \"BTC_USDC-PERPETUAL\",\n    \"type\": \"good_til_cancelled\",  // MUST be \"good_til_cancelled\" - GTD not supported\n    \"contracts\": 4,\n    \"direction\": \"sell\",\n    \"price\": 67500,\n    \"post_only\": true,  // MUST be true for RFQ responses\n    \"mmp\": false,\n    \"liquidation\": false,\n    \"taker\": \"0xf1808cc5298036762329b56b261246c0b77EBb18\",\n    \"maker\": \"0x9a2f0C371820e8BE3D64efb3E814808F231880ff\",\n    \"signature\": \"0x1234...abcdef12\",\n    \"signature_deadline\": 1735689600\n  }\n]\n```\n",
        "minItems": 2,
        "maxItems": 2,
        "items": {
          "type": "object",
          "description": "Either a market order (3 fields) or limit order (all fields)"
        },
        "example": [
          {
            "instrument_name": "BTC_USDC-PERPETUAL",
            "contracts": 4,
            "direction": "buy"
          },
          {
            "instrument_name": "BTC_USDC-PERPETUAL",
            "type": "good_til_cancelled",
            "contracts": 4,
            "direction": "sell",
            "price": 67500,
            "post_only": true,
            "mmp": false,
            "liquidation": false,
            "taker": "0xf1808cc5298036762329b56b261246c0b77EBb18",
            "maker": "0x9a2f0C371820e8BE3D64efb3E814808F231880ff",
            "signature": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
            "signature_deadline": 1735689600
          }
        ]
      }
    }
  }
}
````