# Markets

A market is one on-chain account that fixes every term of a covered call except size and price.

This page is about covered-call markets, the only kind desks quote today. Put markets are a separate account type: see [Cash-secured puts](https://docs.covr.markets/concepts/puts.md).

## Market terms

| Term | Meaning |
| --- | --- |
| Collateral | The token being locked. JitoSOL for desks today. |
| Strike (`strikeE8`) | USD per token, scaled by 10^8. `18_000_000_000n` is $180. |
| Expiry | Unix seconds. All positions on a market expire together. |
| Window | Seconds after expiry when the buyer may exercise: 60 to 3,600. |
| Max quantity | The most collateral atoms one fill may carry. The program also caps every JitoSOL order at 50 SOL of stake-pool value, whatever the market's maximum. |
| Fee (`feeBps`) | covr's cut of the gross premium, at most 1,000 (10%). |
| Paused | A paused market accepts no new fills. |
| Settlement mode | `0` ordinary: exercise is one atomic transaction. `1` restricted: tokenized stocks, covr-only for now. |

## Reading a market

Each RFQ names its market address. Read the account yourself at **finalized** commitment, check its owner is the covr program, then decode it:

```ts
import { PROGRAM_ID, decodeMarketV3 } from '@covrfun/maker-sdk';
import { address, createSolanaRpc } from '@solana/kit';

const rpc = createSolanaRpc(process.env.RPC_URL!);
const { value } = await rpc
  .getAccountInfo(address(marketAddress), { commitment: 'finalized', encoding: 'base64' })
  .send();
if (!value || value.owner !== PROGRAM_ID) throw Error('not a covr market');
const market = await decodeMarketV3(marketAddress, Buffer.from(value.data[0], 'base64'));
if (market.settlementMode !== 0 || market.paused) return; // skip
```

`decodeMarketV3` checks the layout, the mainnet genesis hash, USDC as payment, covr's deployment id, and that the address is the right PDA for its creator and salt.

## Finding markets

Each RFQ names its market address. Read the market from chain, as above, before you bid.

### Official markets

covr lists its markets automatically from a reviewed listing policy. Expiries fall on a weekly UTC calendar. Call strikes are set above the spot price on an anchor read once a week, rounded up to a tick, and then frozen; put strikes are set below spot the same way. The exact strikes, expiries, windows and fees change as markets roll, so never hardcode them: each RFQ names its market, and the market account holds every term. The current listing schedule and strike offsets are to confirm with covr.

### The market catalog

covr's customer app reads the markets it offers from the gateway route `GET /api/ordinary-v3/markets`.

> [!NOTE]
> Desks cannot call this route today. On the gateway host it needs covr's own edge credential, and your desk token does not open it. Your token opens only the three [desk routes](https://docs.covr.markets/reference/gateway/overview.md#the-three-desk-routes).

It takes no query string (a query gets HTTP 400). It returns `{ "version": 1, "mode": "ordinary-v3", "markets": [ … ] }`, one entry per market the gateway currently offers:

| Field | Type | Meaning |
| --- | --- | --- |
| `market` | string | The MarketV3 address. |
| `version`, `bump`, `settlementMode` | number | From the market account. `settlementMode` is `0` (ordinary). |
| `program` | object | `program`, `genesisHash`, `sha256`, `bytes` and `upgradeAuthority` of the program build the gateway trusts. |
| `deploymentId`, `termsId`, `profileHash` | string | `0x` hex. |
| `creator`, `salt` | string | The market's PDA inputs. `salt` is a u64 as a decimal string. |
| `collateral`, `payment` | object | `mint`, `tokenProgram` and `decimals` of JitoSOL and USDC. |
| `feeOwner` | string | Receives the market fee. |
| `expiry`, `window`, `strikeE8`, `maxQuantityAtoms` | string | Integers as decimal strings. |
| `feeBps` | number | The market fee in basis points. |
| `makers` | array | `{ ethAddress, authority }` of each maker the market lists. Today: covr's own maker only. |

`maxQuantityAtoms` is the market's own ceiling. The program's per-order limit of 50 SOL of value still applies on top of it: see [Size rules](#size-rules).

### Is covr quoting right now?

`GET /status/quotes` on the gateway host is public and needs no token. It tells you whether covr's own maker can quote customers at this moment. See [Quote status](https://docs.covr.markets/reference/gateway/overview.md#public-quote-status).

## Size rules

RFQ quantities arrive as decimal strings scaled to 18 decimals. Convert with `atomsFromWire(quantity, decimals)`. Each quantity is a multiple of the market's minimum lot (`minimumExactLot`), so the strike payment is always a whole USDC atom.

Every JitoSOL order is also capped by the program at 50 SOL of stake-pool value (2 SOL before the program upgrade of 4 November 2026). No single fill above that limit can land, whatever the market's `maxQuantityAtoms`. covr's customer app and server apply their own per-order limits, which can be lower; their current values are to confirm with covr. See [Capital and settlement](https://docs.covr.markets/concepts/capital.md#limits-you-set-on-yourself).

## Creating markets

Any wallet can create a market with `createMarketV3`. The program checks:

- expiry is 60 seconds to 90 days away;
- the window is 60 to 3,600 seconds;
- the fee is at most 1,000 bps.

> [!NOTE]
> Markets you create are valid on chain, but customers do not see them yet. Today desks quote on covr's markets.

---

Source: https://docs.covr.markets/concepts/markets · Part of covr Docs, https://docs.covr.markets/llms.txt
