Gateway reference
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. For refusals, see Errors.
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 | /rfqs/<alias> | gateway to desk | none |
| RFQ snapshot | GET /api/rfqs/<id> | desk to gateway | JSON body |
Bid intent bid_intent | /maker | desk to gateway | "BID_ACCEPTED" |
Award award | /maker | gateway to desk | none: answer with a quote or a decline |
Quote quote | /maker | desk to gateway | "OK" |
Award decline award_decline | /maker | desk to gateway | "DECLINED" |
RFQ note rfq_note | /maker | desk to gateway | "NOTED" |
| 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. | "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):
premium (USDC atoms) = quantity × price / 10^30 must be an exact integer, > 0, < 2^64For 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.
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. |
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.
{
"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
| 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. |
curl -sS -H "Authorization: Bearer $COVR_TOKEN" \
https://<provided by covr>/api/rfqs/3f2b8c1e-5d4a-4e7b-9c2d-1a2b3c4d5e6fWhile bids are collected:
{
"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:
{
"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 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'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. |
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.
{
"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). 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 and Signing.
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
{"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.
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 or Award decline. |
{
"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.
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.
{
"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
{"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.
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" |
{
"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. |
{"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.
{
"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_upitself. 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.
{"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:
{
"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. |
A refusal of a quote from the award holder also passes the award on. See Award passing.
Other frames
- The gateway sends desks no message types other than the ones above.
GatewayClientreports any frame it cannot match as anoticeevent. In practice that is a late reply to a request that already timed out, or an error reply with"id": null./makeranswers two leftover methods,positionsandbalances, 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.