Orders & exclusive fills
Besides RFQ settlement on the mothership (On-chain fill modes), the API can record CLOB orders and issue short-lived exclusive fills (maker-only). The trading quote box settles RFQs on-chain via mothership executeIntent (leg-by-leg FillMatched). Post to book for a single call/put uses the mothership / pair CLOB. These REST routes are for bots and exclusive-fill bonding.
Create an order
POST /api/orders — optional bearer token.
{
"chain_id": 31337,
"amount": "1000000000000000000",
"destination": {
"from": "0xTaker",
"to": "0xClobOrMothership",
"nonce": { "prefix": 0, "nonce": "1" }
},
"data": {
"options6909Contract": "0xPairClob",
"rewardLimits": {
"fillerRewardMaxPerMintedUnit": 0,
"fillerRewardMinPerMintedUnit": 0
},
"pairKey": {
"optionType": 0,
"startExecutionTimeStamp": 0,
"expiryTimestamp": 1785950335
},
"decayPremium": {
"premiumStart": 150,
"premiumEnd": 150,
"decayRateBpsPerSecond": 0
},
"decayStrike": {
"strikeStart": "2500000000",
"strikeEnd": "2500000000",
"decayRateBpsPerSecond": 0
},
"decayMinFill": {
"startMinFill": "0",
"decayRatePerSecond": "0"
},
"buyOrSell": 1,
"intentStartTime": 0,
"intentExpiry": 1785950335,
"orderOnExpiry": 0
}
}
201 returns id, owner_address, state, and the echoed destination / data / amount. Open orders also appear on Portfolio once indexed.
Exclusive fill
POST /api/exclusive-fill — authenticated (maker rights).
{
"order_ids": ["…"],
"reward_destination": "0xMaker"
}
Response includes exclusive_fill_id, state, the exclusive_fill payload (expire_time, reward_destination, intent_data_hash), an API signature, and optional fill_bond_requirements.
Makers must meet per-token fill bond minima. Read them from:
GET /api/bond-requirements
{
"tokens": {
"USDC": {
"premium_bond_amount": "0",
"fill_bond_amount": "1000000"
}
}
}
POST /api/premium/activate is removed (410). Do not use SignUp bond stakes for API maker access. The makers UI still shows exclusive-fill minima from this endpoint.
RFQ vs book
| Path | Who | How |
|---|---|---|
| Options RFQ | Taker + makers | POST /api/quote → signed offer → executeIntent |
| Post to book | Taker (UI, singles) | Pair CLOB post (unfilled order) |
| Exclusive fill | Maker | POST /api/orders then POST /api/exclusive-fill |