sage-options

Sage Options

Chia options protocol operations.

Endpoints

Query Options

Endpoint	Payload	Description
get_options	See below	List options
get_option	{"option_id": "..."}	Get specific option
update_option	{"option_id": "...", "visible": true}	Update visibility

get_options Payload

{
  "offset": 0,
  "limit": 50,
  "sort_mode": "name",
  "ascending": false,
  "find_value": null,
  "include_hidden": false
}

Sort modes: "name", "created_height", "expiration_seconds"

Mint Option

{
  "expiration_seconds": 604800,
  "underlying": {
    "asset_id": null,
    "amount": "1000000000000"
  },
  "strike": {
    "asset_id": "a628c1c2...",
    "amount": "100000"
  },
  "fee": "100000000",
  "auto_submit": true
}

• asset_id: null = XCH
• Returns option_id

Exercise Options

{
  "option_ids": ["..."],
  "fee": "100000000",
  "auto_submit": true
}

Transfer Options

{
  "option_ids": ["..."],
  "address": "xch1...",
  "fee": "100000000",
  "clawback": null,
  "auto_submit": true
}

Option Record Structure

{
  "option_id": "...",
  "underlying_asset_id": null,
  "underlying_amount": "1000000000000",
  "strike_asset_id": "a628c1c2...",
  "strike_amount": "100000",
  "expiration_seconds": 604800,
  "created_height": 1234567,
  "visible": true
}

Examples

# List options
sage_rpc get_options '{"limit": 20}'

# Mint option: 1 XCH underlying, 100k CAT strike, 7 day expiry
sage_rpc mint_option '{
  "expiration_seconds": 604800,
  "underlying": {"asset_id": null, "amount": "1000000000000"},
  "strike": {"asset_id": "a628c1c2...", "amount": "100000"},
  "fee": "100000000",
  "auto_submit": true
}'

# Exercise option
sage_rpc exercise_options '{
  "option_ids": ["option123"],
  "fee": "100000000",
  "auto_submit": true
}'

# Transfer option
sage_rpc transfer_options '{
  "option_ids": ["option123"],
  "address": "xch1buyer...",
  "fee": "100000000",
  "auto_submit": true
}'

Notes

• Options allow derivative-style contracts on Chia
• Exercise before expiration to claim underlying
• Expired options can be reclaimed by creator