# Messages

This page lists every message a desk sends or receives, with a full example and a field table for each. For when each one happens, see [RFQ lifecycle](https://docs.covr.markets/reference/gateway/rfq-lifecycle.md). For refusals, see [Errors](https://docs.covr.markets/reference/gateway/errors.md).

The examples use the SDK's golden vectors: a **synthetic** JitoSOL market (strike $170, expiry 2026-10-23 08:00 UTC, not on chain) and a **throwaway** quote key, `privateKey = keccak256(utf8("covr-maker-sdk-golden-vectors-v1"))`. Their signatures verify, so you can test your own encoder against them.


## Summary

| Message | Socket | Direction | Reply |
| --- | --- | --- | --- |
| [RFQ event](#rfq-event) | `/rfqs/<alias>` | gateway to desk | none |
| [RFQ snapshot](#rfq-snapshot) | `GET /api/rfqs/<id>` | desk to gateway | JSON body |
| [Bid intent](#bid-intent) `bid_intent` | `/maker` | desk to gateway | `"BID_ACCEPTED"` |
| [Award](#award) `award` | `/maker` | gateway to desk | none: answer with a quote or a decline |
| [Quote](#quote) `quote` | `/maker` | desk to gateway | `"OK"` |
| [Award decline](#award-decline) `award_decline` | `/maker` | desk to gateway | `"DECLINED"` |
| [RFQ note](#rfq-note) `rfq_note` | `/maker` | desk to gateway | `"NOTED"` |
| [Error reply](#error-reply) | `/maker` or a feed | gateway to desk | none |

## Units and encodings

Every number that can exceed 2^53 travels as a decimal string with no sign, no leading zeros and no exponent. Times travel as JSON numbers.

| Quantity | Wire form | Unit | Example |
| --- | --- | --- | --- |
| `price` | decimal string | Gross premium in USDC per **one whole** collateral token, times 10^18 (priceE18). | `"2400000000000000000"` = 2.40 USDC per JitoSOL |
| `quantity` | decimal string | Collateral in whole tokens, times 10^18. For JitoSOL (9 decimals) this is atoms times 10^9. | `"500000000000000000"` = 0.5 JitoSOL |
| `strike` | decimal string | Strike in USD per whole token, times 10^8 (strikeE8). | `"17000000000"` = $170 |
| `nonce` | decimal string | u64 below 2^64 - 1. | `"1001"` |
| `expiry`, `validUntil` | number | Unix **seconds**. | `1792490463` |
| `closesAt`, `hardDeadline`, `awardUntil` | number | Unix **milliseconds**. | `1792490406000` |
| Asset fields | string | 20-byte alias, `0x` + 40 hex. See [Asset aliases](https://docs.covr.markets/reference/gateway/connection.md#asset-aliases). | `"0x4312...8c68"` |
| `market`, `wallet`, `writer` | string | Solana public key, base58. | `"4aDw...J8HA"` |
| `maker` | string | Your quote key, `0x` + 40 hex. Any letter case. | `"0x7B99...5738"` |
| `signature`, `intentSignature` | string | 65 bytes: `0x` + 130 hex. Last byte `1b` or `1c` (v = 27 or 28). Low s. | |
| RFQ `id` | string | Lowercase UUID version 4. | `"3f2b8c1e-5d4a-4e7b-9c2d-1a2b3c4d5e6f"` |


The premium must come out as a whole number of USDC atoms (6 decimals):

```text
premium (USDC atoms) = quantity × price / 10^30      must be an exact integer, > 0, < 2^64
```

For JitoSOL this is `atoms × price / 10^21`. Example: 0.5 JitoSOL at `price = 2400000000000000000` pays `500000000 × 2.4×10^18 / 10^21 = 1200000` atoms = 1.20 USDC. A price that leaves a remainder is refused. The SDK's `exactPriceAtOrBelow` rounds your price down to the nearest exact one. See [Settlement](https://docs.covr.markets/reference/sdk/settlement.md).


## RFQ event

| | |
| --- | --- |
| Socket | `/rfqs/<alias>` |
| Direction | gateway to desk |
| When | Once, at the moment a customer's request creates the RFQ. Sent to every open feed for that asset, practice-mode desks included. |


> [!WARNING]
> The `rfq` event carries **no market and no customer wallet**. You need both to sign a bid. Call `GET /api/rfqs/<id>` as soon as the event arrives: bids close 3 s after the RFQ was created, and that read is part of your 3 s.


```json
{
  "jsonrpc": "2.0",
  "id": "3f2b8c1e-5d4a-4e7b-9c2d-1a2b3c4d5e6f",
  "result": {
    "asset": "0x43127405c3191a0b63a5f3d845f616ffea348c68",
    "assetName": "Ordinary token",
    "chainId": 2000000001,
    "expiry": 1792742400,
    "isPut": false,
    "isTakerBuy": false,
    "quantity": "500000000000000000",
    "strike": "17000000000",
    "taker": "0x0000000000000000000000000000000000000000",
    "usd": "0x5ce3bf3a31af18be40ba30f721101b4341690186",
    "collateralAsset": "0x43127405c3191a0b63a5f3d845f616ffea348c68"
  }
}
```

`id` is the RFQ id. `result` is the request:

| Name | Type | Description |
| --- | --- | --- |
| `asset` | string | Collateral alias. Equals the alias in the feed path. |
| `assetName` | string | Always `"Ordinary token"`. Display only. |
| `chainId` | number | Always `2000000001`. A venue tag for EIP-712, not an EVM chain. |
| `expiry` | number | Option expiry, unix seconds. |
| `isPut` | boolean | Always `false`: covered calls only. |
| `isTakerBuy` | boolean | Always `false`: the customer sells the call, you buy it. |
| `quantity` | string | Size, whole tokens times 10^18. |
| `strike` | string | Strike, USD times 10^8 per whole token. |
| `taker` | string | Always the zero address. The customer's wallet is in the snapshot. |
| `usd` | string | Payment alias (USDC). |
| `collateralAsset` | string | Same as `asset`. |


Read `market` and `wallet` from the [RFQ snapshot](#rfq-snapshot).

## RFQ snapshot

| | |
| --- | --- |
| Route | `GET /api/rfqs/<id>` with `Authorization: Bearer <token>` |
| Direction | desk to gateway, JSON response |
| When | Any time while the gateway remembers the RFQ: 120 s to 130 s after creation. |


```sh
curl -sS -H "Authorization: Bearer $COVR_TOKEN" \
  https://<provided by covr>/api/rfqs/3f2b8c1e-5d4a-4e7b-9c2d-1a2b3c4d5e6f
```

While bids are collected:

```json
{
  "id": "3f2b8c1e-5d4a-4e7b-9c2d-1a2b3c4d5e6f",
  "kind": "open",
  "position": null,
  "status": "collecting",
  "market": "3ZyjE1mByRWXfGhKX1qt1LmqVueWc78KgTo8ik9fiXxH",
  "preparationFamily": "ordinary-v3",
  "closesAt": 1792490403000,
  "hardDeadline": 1792490406000,
  "bidCount": 0,
  "wallet": "4aDwH64QdwwvrkVRxJbTPj78YRsaqV7Ru1HipKuCJ8HA",
  "executionEnabled": false,
  "preparationEnabled": true,
  "mode": "settlement-preparation",
  "request": {
    "asset": "0x43127405c3191a0b63a5f3d845f616ffea348c68",
    "assetName": "Ordinary token",
    "chainId": 2000000001,
    "expiry": 1792742400,
    "isPut": false,
    "isTakerBuy": false,
    "quantity": "500000000000000000",
    "strike": "17000000000",
    "taker": "0x0000000000000000000000000000000000000000",
    "usd": "0x5ce3bf3a31af18be40ba30f721101b4341690186",
    "collateralAsset": "0x43127405c3191a0b63a5f3d845f616ffea348c68"
  }
}
```

After **your** quote was admitted, your read adds three fields:

```json
{
  "id": "3f2b8c1e-5d4a-4e7b-9c2d-1a2b3c4d5e6f",
  "kind": "open",
  "position": null,
  "status": "quoted",
  "market": "3ZyjE1mByRWXfGhKX1qt1LmqVueWc78KgTo8ik9fiXxH",
  "preparationFamily": "ordinary-v3",
  "closesAt": 1792490403000,
  "hardDeadline": 1792490406000,
  "bidCount": 1,
  "wallet": "4aDwH64QdwwvrkVRxJbTPj78YRsaqV7Ru1HipKuCJ8HA",
  "executionEnabled": false,
  "preparationEnabled": true,
  "mode": "settlement-preparation",
  "request": {
    "asset": "0x43127405c3191a0b63a5f3d845f616ffea348c68",
    "assetName": "Ordinary token",
    "chainId": 2000000001,
    "expiry": 1792742400,
    "isPut": false,
    "isTakerBuy": false,
    "quantity": "500000000000000000",
    "strike": "17000000000",
    "taker": "0x0000000000000000000000000000000000000000",
    "usd": "0x5ce3bf3a31af18be40ba30f721101b4341690186",
    "collateralAsset": "0x43127405c3191a0b63a5f3d845f616ffea348c68"
  },
  "quote": {
    "auctionId": "3f2b8c1e-5d4a-4e7b-9c2d-1a2b3c4d5e6f",
    "writer": "4aDwH64QdwwvrkVRxJbTPj78YRsaqV7Ru1HipKuCJ8HA",
    "assetAddress": "0x43127405c3191a0b63a5f3d845f616ffea348c68",
    "chainId": 2000000001,
    "isPut": false,
    "strike": "17000000000",
    "expiry": 1792742400,
    "maker": "0x7B99e6A7407Fe0058119F4f13494C0b9cec35738",
    "nonce": "1001",
    "price": "2400000000000000000",
    "quantity": "500000000000000000",
    "isTakerBuy": false,
    "validUntil": 1792490463,
    "usd": "0x5ce3bf3a31af18be40ba30f721101b4341690186",
    "collateralAsset": "0x43127405c3191a0b63a5f3d845f616ffea348c68",
    "signature": "0xe8e829e6106ac480abd418bcc039cd959a48a65a6c55f716209562564a3f66a4250bcb3a4e39c7e00135ec1bc0c306ede8422b30e5470a55f4af81a72f8b4a691c"
  },
  "premiumBaseUnits": "1200000",
  "collateralBaseUnits": "500000000"
}
```


| Name | Type | Description |
| --- | --- | --- |
| `id` | string | RFQ id. Sign it into your bid as `auctionId`. |
| `kind` | string | Always `"open"` for desk RFQs: a customer opening a new covered call. |
| `position` | null | Always `null` for opening RFQs. |
| `status` | string | `collecting`, `finalizing`, `quoted` or `no_quote`. See below. |
| `market` | string | The market account. Read it from chain and sign in its EIP-712 domain. |
| `preparationFamily` | string | Always `"ordinary-v3"` for desk RFQs. |
| `noQuoteReason` | string | Only when `status` is `no_quote` and a reason was given. One of the [RFQ note](#rfq-note) reasons. |
| `closesAt` | number | Bid collection ends, unix ms. Creation time plus 3 000. |
| `hardDeadline` | number | No quote is admitted at or after this, unix ms. Creation time plus 6 000. |
| `bidCount` | number | Bids entered in the auction so far. Practice-mode bids are not counted. |
| `wallet` | string | The customer's Solana wallet, which writes the call. Sign it into your bid as `wallet` and into your quote as `writer`. |
| `executionEnabled` | boolean | Always `false`. Ignore. |
| `preparationEnabled` | boolean | Always `true` for desk RFQs. Ignore. |
| `mode` | string | Always `"settlement-preparation"`. Ignore. |
| `request` | object | The same object as the [RFQ event](#rfq-event)'s `result`. |
| `quote` | object | Winner only. The admitted quote, exactly as you sent it. |
| `premiumBaseUnits` | string | Winner only. Gross premium in USDC atoms. The market fee is taken out of it on chain. |
| `collateralBaseUnits` | string | Winner only. Collateral in atoms. |


Sealed bids stay sealed. A desk that did not win never sees the winning price, maker or signature. The gateway may add fields later: ignore any you do not know.


### Status values

| Status | Meaning |
| --- | --- |
| `collecting` | Bids are open. Before `closesAt`. |
| `finalizing` | Bids are closed. An award is out, a quote is being admitted, or a ranked bid is still to be offered. Before `hardDeadline`. |
| `quoted` | A quote was admitted. Final. |
| `no_quote` | No quote was admitted: no bids, every bidder declined or failed, or the hard deadline passed. Final. |


> [!NOTE]
> `quoted` stays `quoted` after the quote's `validUntil`. From then on the winner's read no longer carries `quote`, `premiumBaseUnits` or `collateralBaseUnits`. Whether the customer filled is visible only on chain.


## Bid intent

| | |
| --- | --- |
| Method | `bid_intent` |
| Socket | `/maker` |
| Direction | desk to gateway |
| When | After you read the snapshot, before `closesAt`. One per maker per RFQ. |
| JSON-RPC `id` | The RFQ id. |
| Reply | `"BID_ACCEPTED"` |

A bid intent is your sealed bid: a price, signed, with no nonce and no cash commitment yet. The gateway ranks intents when collection closes and awards the best.

```json
{
  "jsonrpc": "2.0",
  "id": "3f2b8c1e-5d4a-4e7b-9c2d-1a2b3c4d5e6f",
  "method": "bid_intent",
  "params": {
    "auctionId": "3f2b8c1e-5d4a-4e7b-9c2d-1a2b3c4d5e6f",
    "kind": "open",
    "market": "3ZyjE1mByRWXfGhKX1qt1LmqVueWc78KgTo8ik9fiXxH",
    "position": null,
    "wallet": "4aDwH64QdwwvrkVRxJbTPj78YRsaqV7Ru1HipKuCJ8HA",
    "assetAddress": "0x43127405c3191a0b63a5f3d845f616ffea348c68",
    "chainId": 2000000001,
    "expiry": 1792742400,
    "isPut": false,
    "isTakerBuy": false,
    "quantity": "500000000000000000",
    "strike": "17000000000",
    "usd": "0x5ce3bf3a31af18be40ba30f721101b4341690186",
    "collateralAsset": "0x43127405c3191a0b63a5f3d845f616ffea348c68",
    "maker": "0x7B99e6A7407Fe0058119F4f13494C0b9cec35738",
    "price": "2400000000000000000",
    "validUntil": 1792490466,
    "signature": "0xcf12abfcee5e71e15375685b4b4f52bd74e31b540e8eb6ca9c806a7ea391ee38433d33b1b7c81b2c9964096272a9ee680b9766b801caa81b694240020a57460a1b"
  }
}
```

`params` has exactly these 18 fields. A missing or extra field is refused.

| Name | Type | Description |
| --- | --- | --- |
| `auctionId` | string | The RFQ id. Must equal the JSON-RPC `id`. |
| `kind` | string | `"open"`. |
| `market` | string | Snapshot `market`. |
| `position` | null | `null`. |
| `wallet` | string | Snapshot `wallet`. |
| `assetAddress` | string | Request `asset`, copied exactly (lowercase). |
| `chainId` | number | Request `chainId`. |
| `expiry` | number | Request `expiry`. |
| `isPut` | boolean | Request `isPut` (`false`). |
| `isTakerBuy` | boolean | Request `isTakerBuy` (`false`). |
| `quantity` | string | Request `quantity`, copied exactly. |
| `strike` | string | Request `strike`, copied exactly. |
| `usd` | string | Request `usd`, copied exactly. |
| `collateralAsset` | string | Request `collateralAsset`, copied exactly. |
| `maker` | string | Your registered quote key. A key other than the one your token maps to is refused. |
| `price` | string | Your bid, priceE18. Positive, and the premium must be a whole number of USDC atoms (see [Units](#units-and-encodings)). This is the price you must quote if you win. |
| `validUntil` | number | Unix seconds. Later than the gateway's clock, later than `ceil(closesAt / 1000)`, and not later than `expiry`. The SDK default is `min(expiry, ceil(hardDeadline / 1000) + 60)`. |
| `signature` | string | EIP-712 signature of the `BidIntent` typed data by `maker`, in the market's domain. |


The instrument fields are compared as exact values, so copy them from the RFQ. Do not re-encode them.

### Signed as

Domain: `{name: "SOL Covered Calls", version: "1", chainId: 2000000001, verifyingContract}`, where `verifyingContract` is derived from the market account's terms. Get it with the SDK's `marketDomain(marketAddress, accountData)`. See [Markets](https://docs.covr.markets/reference/sdk/markets.md) and [Signing](https://docs.covr.markets/reference/sdk/signing.md).


Primary type `BidIntent`, fields in this order:

| Field | EIP-712 type | Value signed |
| --- | --- | --- |
| `auctionId` | `bytes32` | `keccak256(utf8(rfqId))` |
| `kind` | `uint8` | `0` for `"open"` |
| `market` | `bytes32` | The market's 32-byte public key |
| `position` | `bytes32` | 32 zero bytes for `null` |
| `wallet` | `bytes32` | The wallet's 32-byte public key |
| `assetAddress` | `address` | as sent |
| `chainId` | `uint256` | as sent |
| `isPut` | `bool` | as sent |
| `strike` | `uint256` | as sent |
| `expiry` | `uint64` | as sent |
| `maker` | `address` | as sent |
| `price` | `uint256` | as sent |
| `quantity` | `uint256` | as sent |
| `isTakerBuy` | `bool` | as sent |
| `validUntil` | `uint64` | as sent |
| `usd` | `address` | as sent |
| `collateralAsset` | `address` | as sent |


The golden vector above hashes to digest `0xea259d586b8e39bea882c410e157308254bdfeee6c94201ad671369a8de9bb12` under verifying contract `0x21a8f3a5ea7cf85099905bcf8f065f1d148a80f3`.


### Reply

```json
{"jsonrpc": "2.0", "id": "3f2b8c1e-5d4a-4e7b-9c2d-1a2b3c4d5e6f", "result": "BID_ACCEPTED"}
```

`BID_ACCEPTED` means your bid entered the auction. It is not an award. In practice mode the frame is refused with `Bid intent verified but not entered: this market does not list this maker yet` after the field, term, price and signature checks pass. That refusal tells you your encoding and signature are correct. It does not check the 3 s deadline or the one-bid rule: see [Practice mode](https://docs.covr.markets/reference/gateway/rfq-lifecycle.md#practice-mode).


## Award

| | |
| --- | --- |
| Method | `award` |
| Socket | `/maker`: the same socket that sent the winning bid intent |
| Direction | gateway to desk |
| When | When collection closes and yours is the best bid, or later when the award passes to you. |
| JSON-RPC `id` | The RFQ id. |
| Reply | None. Answer with [Quote](#quote) or [Award decline](#award-decline). |

```json
{
  "jsonrpc": "2.0",
  "id": "3f2b8c1e-5d4a-4e7b-9c2d-1a2b3c4d5e6f",
  "method": "award",
  "params": {
    "intent": {
      "auctionId": "3f2b8c1e-5d4a-4e7b-9c2d-1a2b3c4d5e6f",
      "kind": "open",
      "market": "3ZyjE1mByRWXfGhKX1qt1LmqVueWc78KgTo8ik9fiXxH",
      "position": null,
      "wallet": "4aDwH64QdwwvrkVRxJbTPj78YRsaqV7Ru1HipKuCJ8HA",
      "assetAddress": "0x43127405c3191a0b63a5f3d845f616ffea348c68",
      "chainId": 2000000001,
      "expiry": 1792742400,
      "isPut": false,
      "isTakerBuy": false,
      "quantity": "500000000000000000",
      "strike": "17000000000",
      "usd": "0x5ce3bf3a31af18be40ba30f721101b4341690186",
      "collateralAsset": "0x43127405c3191a0b63a5f3d845f616ffea348c68",
      "maker": "0x7B99e6A7407Fe0058119F4f13494C0b9cec35738",
      "price": "2400000000000000000",
      "validUntil": 1792490466,
      "signature": "0xcf12abfcee5e71e15375685b4b4f52bd74e31b540e8eb6ca9c806a7ea391ee38433d33b1b7c81b2c9964096272a9ee680b9766b801caa81b694240020a57460a1b"
    },
    "awardUntil": 1792490406000,
    "hardDeadline": 1792490406000
  }
}
```


| Name | Type | Description |
| --- | --- | --- |
| `params.intent` | object | Your winning bid intent, as the gateway validated it, signature included. |
| `params.awardUntil` | number | Your quote must be admitted before this, unix ms. In practice it equals `hardDeadline`. |
| `params.hardDeadline` | number | The RFQ's hard deadline, unix ms. |


Answer only an award whose `intent` equals the intent you signed and sent. Build your quote from your own stored copy, not from the copy in the award. If you will not quote, decline at once so the next maker gets the RFQ.


## Quote

| | |
| --- | --- |
| Method | `quote` |
| Socket | `/maker`: the same socket that received the award |
| Direction | desk to gateway |
| When | After an award, before `awardUntil`. Once. |
| JSON-RPC `id` | The RFQ id. |
| Reply | `"OK"` |

The quote is the executable order the customer signs against. It adds a nonce and a short validity to your winning price and binds both to this RFQ and this customer wallet.

> [!CAUTION]
> Write the nonce, the full quote terms and the cash they can cost to durable storage **before** you sign. A reply can time out after the gateway admitted the quote. Treat any quote you signed as live until its `validUntil` has passed on chain.


```json
{
  "jsonrpc": "2.0",
  "id": "3f2b8c1e-5d4a-4e7b-9c2d-1a2b3c4d5e6f",
  "method": "quote",
  "params": {
    "intentSignature": "0xcf12abfcee5e71e15375685b4b4f52bd74e31b540e8eb6ca9c806a7ea391ee38433d33b1b7c81b2c9964096272a9ee680b9766b801caa81b694240020a57460a1b",
    "quote": {
      "auctionId": "3f2b8c1e-5d4a-4e7b-9c2d-1a2b3c4d5e6f",
      "writer": "4aDwH64QdwwvrkVRxJbTPj78YRsaqV7Ru1HipKuCJ8HA",
      "assetAddress": "0x43127405c3191a0b63a5f3d845f616ffea348c68",
      "chainId": 2000000001,
      "isPut": false,
      "strike": "17000000000",
      "expiry": 1792742400,
      "maker": "0x7B99e6A7407Fe0058119F4f13494C0b9cec35738",
      "nonce": "1001",
      "price": "2400000000000000000",
      "quantity": "500000000000000000",
      "isTakerBuy": false,
      "validUntil": 1792490463,
      "usd": "0x5ce3bf3a31af18be40ba30f721101b4341690186",
      "collateralAsset": "0x43127405c3191a0b63a5f3d845f616ffea348c68",
      "signature": "0xe8e829e6106ac480abd418bcc039cd959a48a65a6c55f716209562564a3f66a4250bcb3a4e39c7e00135ec1bc0c306ede8422b30e5470a55f4af81a72f8b4a691c"
    }
  }
}
```

`params` has exactly two fields:

| Name | Type | Description |
| --- | --- | --- |
| `intentSignature` | string | The `signature` of the intent you were awarded. |
| `quote` | object | The signed QuoteV2 below. |


`quote` has exactly these 16 fields:

| Name | Type | Description |
| --- | --- | --- |
| `auctionId` | string | The RFQ id. |
| `writer` | string | Snapshot `wallet`. |
| `assetAddress` | string | The collateral alias. |
| `chainId` | number | `2000000001`. |
| `isPut` | boolean | `false`. |
| `strike` | string | Request `strike`. |
| `expiry` | number | Request `expiry`. |
| `maker` | string | Your registered quote key. Same as the awarded intent. |
| `nonce` | string | A u64 you have never used, below 2^64 - 1. It must be at or above your on-chain `min_nonce`, or the fill fails. |
| `price` | string | Exactly the awarded intent's `price`. |
| `quantity` | string | Request `quantity`. |
| `isTakerBuy` | boolean | `false`. |
| `validUntil` | number | Unix seconds. `now < validUntil <= now + 60`, where `now` is the gateway's clock when it starts admitting this quote (not the RFQ's creation time), and `validUntil <= expiry`. It must still be in the future when admission ends. Leave a few seconds of margin. The example bot uses its own `now + 55`. |
| `usd` | string | The USDC alias. |
| `collateralAsset` | string | The collateral alias. |
| `signature` | string | EIP-712 signature of the `QuoteV2` typed data by `maker`, in the same market domain as the intent. Low s. |


Primary type `QuoteV2`, fields in this order: `auctionId` (`bytes32`, `keccak256(utf8(rfqId))`), `writer` (`bytes32`, the wallet's 32-byte public key), `assetAddress` (`address`), `chainId` (`uint256`), `isPut` (`bool`), `strike` (`uint256`), `expiry` (`uint64`), `maker` (`address`), `nonce` (`uint64`), `price` (`uint256`), `quantity` (`uint256`), `isTakerBuy` (`bool`), `validUntil` (`uint64`), `usd` (`address`), `collateralAsset` (`address`). The golden vector above hashes to digest `0x1c85fe837a80e9fc414d54e78932acdf85f8d0ccb0cc97d934460892455fa958`.


### Reply

```json
{"jsonrpc": "2.0", "id": "3f2b8c1e-5d4a-4e7b-9c2d-1a2b3c4d5e6f", "result": "OK"}
```

`OK` means the gateway admitted your quote and is showing it to the customer. **It is not a fill.** The customer may sign the fill before `validUntil`, or may not. The gateway sends no fill message. Watch your position PDA on chain. See [What OK means](https://docs.covr.markets/reference/gateway/rfq-lifecycle.md#what-ok-means).


## Award decline

| | |
| --- | --- |
| Method | `award_decline` |
| Socket | `/maker`: the same socket that received the award |
| Direction | desk to gateway |
| When | After an award you will not quote. As early as you can. |
| JSON-RPC `id` | The RFQ id. |
| Reply | `"DECLINED"` |

```json
{
  "jsonrpc": "2.0",
  "id": "3f2b8c1e-5d4a-4e7b-9c2d-1a2b3c4d5e6f",
  "method": "award_decline",
  "params": {
    "intentSignature": "0xcf12abfcee5e71e15375685b4b4f52bd74e31b540e8eb6ca9c806a7ea391ee38433d33b1b7c81b2c9964096272a9ee680b9766b801caa81b694240020a57460a1b"
  }
}
```

| Name | Type | Description |
| --- | --- | --- |
| `intentSignature` | string | The `signature` of the intent you were awarded. The only field. |

```json
{"jsonrpc": "2.0", "id": "3f2b8c1e-5d4a-4e7b-9c2d-1a2b3c4d5e6f", "result": "DECLINED"}
```

The award passes at once to the next ranked bid. You cannot take it back. A **refused** `award_decline` passes nothing: you keep the award. Fix the frame and resend it before `awardUntil`, or the RFQ ends with no quote.


## RFQ note

| | |
| --- | --- |
| Method | `rfq_note` |
| Socket | `/maker` |
| Direction | desk to gateway |
| When | When you will not bid on an RFQ and want the customer told why. |
| JSON-RPC `id` | Any string up to 128 characters. `GatewayClient` uses a fresh UUID. |
| Reply | `"NOTED"` |

A note is display-only. It never changes ranking, an award or a quote. The customer sees it only if the RFQ ends `no_quote`.

```json
{
  "jsonrpc": "2.0",
  "id": "9b6f0c3a-2d1e-4f5a-8b7c-6d5e4f3a2b1c",
  "method": "rfq_note",
  "params": {
    "rfqId": "3f2b8c1e-5d4a-4e7b-9c2d-1a2b3c4d5e6f",
    "reason": "fully_booked"
  }
}
```

| Name | Type | Description |
| --- | --- | --- |
| `rfqId` | string | The RFQ id. |
| `reason` | string | One of the five reasons below. |


| Reason | What the customer is told, in short |
| --- | --- |
| `warming_up` | Quotes are starting. Try again in a minute. |
| `fully_booked` | The maker has no room for new orders. Try a smaller amount or later. |
| `wallet_limit` | This wallet already has quotes waiting. Sign one or wait for them to expire. |
| `too_large` | The amount is more than the maker quotes for this market. Try a smaller amount. |
| `not_priced` | This market has no live price right now. |


Rules:

- Only a desk the market lists may note. A practice-mode desk is refused.
- The first maker to note an RFQ owns its reason. Another maker's note is refused. The owner may change its own reason.
- If no maker that can quote was listening when the RFQ was created, the gateway sets `warming_up` itself. A listed desk's note replaces it.
- The gateway accepts a note while it remembers the RFQ (about 120 s), even after the auction has ended. Send it as soon as you decide not to bid.


```json
{"jsonrpc": "2.0", "id": "9b6f0c3a-2d1e-4f5a-8b7c-6d5e4f3a2b1c", "result": "NOTED"}
```

## Error reply

Any refused request gets one error reply on the socket that sent it:

```json
{
  "jsonrpc": "2.0",
  "id": "3f2b8c1e-5d4a-4e7b-9c2d-1a2b3c4d5e6f",
  "error": {
    "code": -32602,
    "message": "Bid intent verified but not entered: this market does not list this maker yet"
  }
}
```

| Name | Type | Description |
| --- | --- | --- |
| `id` | string or null | The request's `id`. `null` when the frame was not valid JSON-RPC, so no `id` could be read. |
| `error.code` | number | Always `-32602`. |
| `error.message` | string | Why. The full list is in [Errors](https://docs.covr.markets/reference/gateway/errors.md). |


A refusal of a `quote` from the award holder also passes the award on. See [Award passing](https://docs.covr.markets/reference/gateway/rfq-lifecycle.md#award-passing).

## Other frames

- The gateway sends desks no message types other than the ones above.
- `GatewayClient` reports any frame it cannot match as a `notice` event. In practice that is a late reply to a request that already timed out, or an error reply with `"id": null`.
- `/maker` answers two leftover methods, `positions` and `balances`, with fixed empty values (`[]` and `{"mode":"local-sandbox","balances":[],"fundingEnabled":false}`). They carry no information about your desk. Do not use them.
- Any other method is refused. See [Errors](https://docs.covr.markets/reference/gateway/errors.md#any-frame).

---

Source: https://docs.covr.markets/reference/gateway/messages · Part of covr Docs, https://docs.covr.markets/llms.txt
