QuoteResponseKind

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/cow-protocol/json-schema/cow-protocol-quote-response-kind-schema.json",
  "title": "QuoteResponseKind",
  "x-generated": "2026-10-28",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/driver.yml#/components/schemas/QuoteResponseKind",
  "oneOf": [
    {
      "$ref": "#/$defs/LegacyQuoteResponse"
    },
    {
      "$ref": "#/$defs/QuoteResponse"
    },
    {
      "$ref": "#/$defs/Error"
    }
  ],
  "$defs": {
    "Address": {
      "description": "20 byte Ethereum address encoded as a hex with `0x` prefix.",
      "type": "string"
    },
    "BigUint": {
      "description": "A big unsigned integer encoded in decimal.",
      "type": "string"
    },
    "Error": {
      "description": "Response on API errors.",
      "type": "object",
      "properties": {
        "kind": {
          "description": "The kind of error.",
          "type": "string"
        },
        "description": {
          "description": "Text describing the error.",
          "type": "string"
        }
      }
    },
    "Interaction": {
      "type": "object",
      "properties": {
        "target": {
          "$ref": "#/$defs/Address"
        },
        "value": {
          "$ref": "#/$defs/TokenAmount"
        },
        "callData": {
          "description": "Hex encoded bytes with `0x` prefix.",
          "type": "string"
        }
      }
    },
    "JitOrder": {
      "type": "object",
      "properties": {
        "sellToken": {
          "$ref": "#/$defs/Address"
        },
        "buyToken": {
          "$ref": "#/$defs/Address"
        },
        "sellAmount": {
          "$ref": "#/$defs/TokenAmount"
        },
        "buyAmount": {
          "$ref": "#/$defs/TokenAmount"
        },
        "executedAmount": {
          "$ref": "#/$defs/TokenAmount"
        },
        "receiver": {
          "$ref": "#/$defs/Address"
        },
        "validTo": {
          "type": "integer"
        },
        "side": {
          "type": "string",
          "enum": [
            "buy",
            "sell"
          ]
        },
        "partiallyFillable": {
          "type": "boolean"
        },
        "sellTokenSource": {
          "type": "string",
          "enum": [
            "erc20",
            "internal",
            "external"
          ]
        },
        "buyTokenSource": {
          "type": "string",
          "enum": [
            "erc20",
            "internal"
          ]
        },
        "appData": {
          "type": "string"
        },
        "signature": {
          "description": "Hex encoded bytes with `0x` prefix. The content depends on the `signingScheme`.\nFor `presign`, this should contain the address of the owner.\nFor `eip1271`, the signature should consist of `<owner_address><signature_bytes>`.",
          "type": "string"
        },
        "signingScheme": {
          "type": "string",
          "enum": [
            "eip712",
            "ethsign",
            "presign",
            "eip1271"
          ]
        }
      },
      "required": [
        "sellToken",
        "buyToken",
        "sellAmount",
        "buyAmount",
        "executedAmount",
        "receiver",
        "validTo",
        "side",
        "partiallyFillable",
        "sellTokenSource",
        "buyTokenSource",
        "appData",
        "signature",
        "signingScheme"
      ]
    },
    "LegacyQuoteResponse": {
      "description": "Successful Quote.\n\nThe Solver knows how to fill the request with these parameters.\n\nIf the request was of type `buy` then the response's buy amount has the\nsame value as the request's amount and the sell amount was filled in by\nthe server. Vice versa for type `sell`.",
      "type": "object",
      "properties": {
        "amount": {
          "$ref": "#/$defs/TokenAmount"
        },
        "interactions": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Interaction"
          }
        },
        "solver": {
          "allOf": [
            {
              "description": "The address of the solver that quoted this order."
            },
            {
              "$ref": "#/$defs/Address"
            }
          ]
        },
        "gas": {
          "type": "integer",
          "description": "How many units of gas this trade is estimated to cost."
        },
        "txOrigin": {
          "allOf": [
            {
              "$ref": "#/$defs/Address"
            }
          ],
          "description": "Which `tx.origin` is required to make a quote simulation pass."
        }
      },
      "required": [
        "amount",
        "interactions",
        "solver"
      ]
    },
    "QuoteResponse": {
      "description": "Successful Quote with JIT orders support.\nThe Solver knows how to fill the request with these parameters.",
      "type": "object",
      "properties": {
        "clearingPrices": {
          "description": "Mapping of hex token address to the uniform clearing price.\n",
          "type": "object",
          "additionalProperties": {
            "$ref": "#/$defs/BigUint"
          }
        },
        "preInteractions": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Interaction"
          }
        },
        "interactions": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Interaction"
          }
        },
        "solver": {
          "allOf": [
            {
              "$ref": "#/$defs/Address"
            }
          ],
          "description": "The address of the solver that quoted this order."
        },
        "gas": {
          "type": "integer",
          "description": "How many units of gas this trade is estimated to cost."
        },
        "txOrigin": {
          "allOf": [
            {
              "$ref": "#/$defs/Address"
            }
          ],
          "description": "Which `tx.origin` is required to make a quote simulation pass."
        },
        "jitOrders": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/JitOrder"
          }
        },
        "supportsFastPath": {
          "type": "boolean",
          "description": "Whether the quoting solver supports fast-path (out-of-competition) execution."
        }
      },
      "required": [
        "clearingPrices",
        "solver"
      ]
    },
    "TokenAmount": {
      "description": "Amount of an ERC20 token. 256 bit unsigned integer in decimal notation.",
      "type": "string"
    }
  }
}