covr.Docs

Concepts

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.

Market terms

TermMeaning
CollateralThe token being locked. JitoSOL for desks today.
Strike (strikeE8)USD per token, scaled by 10^8. 18_000_000_000n is $180.
ExpiryUnix seconds. All positions on a market expire together.
WindowSeconds after expiry when the buyer may exercise: 60 to 3,600.
Max quantityThe 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%).
PausedA paused market accepts no new fills.
Settlement mode0 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.

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:

FieldTypeMeaning
marketstringThe MarketV3 address.
version, bump, settlementModenumberFrom the market account. settlementMode is 0 (ordinary).
programobjectprogram, genesisHash, sha256, bytes and upgradeAuthority of the program build the gateway trusts.
deploymentId, termsId, profileHashstring0x hex.
creator, saltstringThe market's PDA inputs. salt is a u64 as a decimal string.
collateral, paymentobjectmint, tokenProgram and decimals of JitoSOL and USDC.
feeOwnerstringReceives the market fee.
expiry, window, strikeE8, maxQuantityAtomsstringIntegers as decimal strings.
feeBpsnumberThe market fee in basis points.
makersarray{ 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.

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.

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.

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.