Servers Playground How we check Add a server Log in

The Spice Melange Trading Desk: DeepBook market data connector

Working · 1.7 s

io.github.SajanMelcher/plumbline-mcpv0.3.3

A Mentat's eye on Sui DeepBook v3: read-only market data plus desk template tools. No keys.

Crypto & Web3

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://plumbline-mcp.fly.dev/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

build_bm_deposit_tx Read-only

Deposit a coin from your wallet into your own BalanceManager. Returns UNSIGNED tx bytes (simulated against mainnet). Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

coinstring, required

Coin symbol: SUI, USDC, WAL, DEEP, CETUS

amountnumber, required

Amount of the from coin in human units, e.g. 2.5

senderstring, required

YOUR Sui address (0x...). Public address only; never send a key.

balance_manager_idstring, required

YOUR DeepBook BalanceManager id (0x + 64 hex), from build_create_balance_manager_tx effects

The Spice Melange Trading Desk: DeepBook market data connector MCP server | mcptry

Tools (31)

build_bm_deposit_tx

read-only

Argument	Type	Description
coin*	string	Coin symbol: SUI, USDC, WAL, DEEP, CETUS
amount*	number	Amount of the from coin in human units, e.g. 2.5
sender*	string	YOUR Sui address (0x...). Public address only; never send a key.
balance_manager_id*	string	YOUR DeepBook BalanceManager id (0x + 64 hex), from build_create_balance_manager_tx effects

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "sender",
    "balance_manager_id",
    "coin",
    "amount"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "maxLength": 10,
      "minLength": 2,
      "description": "Coin symbol: SUI, USDC, WAL, DEEP, CETUS"
    },
    "amount": {
      "type": "number",
      "maximum": 1000000000000,
      "description": "Amount of the from coin in human units, e.g. 2.5",
      "exclusiveMinimum": 0
    },
    "sender": {
      "type": "string",
      "maxLength": 70,
      "minLength": 3,
      "description": "YOUR Sui address (0x...). Public address only; never send a key."
    },
    "balance_manager_id": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$",
      "description": "YOUR DeepBook BalanceManager id (0x + 64 hex), from build_create_balance_manager_tx effects"
    }
  },
  "additionalProperties": false
}

build_bm_withdraw_tx

Withdraw a coin from your own BalanceManager back to your address (always to the owner). Returns UNSIGNED tx bytes (simulated against mainnet). Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

read-only

Argument	Type	Description
coin*	string	Coin symbol: SUI, USDC, WAL, DEEP, CETUS
amount*	number	Amount of the from coin in human units, e.g. 2.5
sender*	string	YOUR Sui address (0x...). Public address only; never send a key.
balance_manager_id*	string	YOUR DeepBook BalanceManager id (0x + 64 hex), from build_create_balance_manager_tx effects

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "sender",
    "balance_manager_id",
    "coin",
    "amount"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "maxLength": 10,
      "minLength": 2,
      "description": "Coin symbol: SUI, USDC, WAL, DEEP, CETUS"
    },
    "amount": {
      "type": "number",
      "maximum": 1000000000000,
      "description": "Amount of the from coin in human units, e.g. 2.5",
      "exclusiveMinimum": 0
    },
    "sender": {
      "type": "string",
      "maxLength": 70,
      "minLength": 3,
      "description": "YOUR Sui address (0x...). Public address only; never send a key."
    },
    "balance_manager_id": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$",
      "description": "YOUR DeepBook BalanceManager id (0x + 64 hex), from build_create_balance_manager_tx effects"
    }
  },
  "additionalProperties": false
}

build_cancel_order_tx

Cancel one order (order_id) or all your orders in a pool, and withdraw settled amounts into your BalanceManager. Returns UNSIGNED tx bytes (simulated against mainnet). Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

read-only

Argument	Type	Description
pool*	string	DeepBook pool BASE_QUOTE, e.g. SUI_USDC
sender*	string	YOUR Sui address (0x...). Public address only; never send a key.
order_id	string
balance_manager_id*	string	YOUR DeepBook BalanceManager id (0x + 64 hex), from build_create_balance_manager_tx effects

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "sender",
    "balance_manager_id",
    "pool"
  ],
  "properties": {
    "pool": {
      "type": "string",
      "maxLength": 30,
      "minLength": 3,
      "description": "DeepBook pool BASE_QUOTE, e.g. SUI_USDC"
    },
    "sender": {
      "type": "string",
      "maxLength": 70,
      "minLength": 3,
      "description": "YOUR Sui address (0x...). Public address only; never send a key."
    },
    "order_id": {
      "type": "string",
      "maxLength": 40
    },
    "balance_manager_id": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$",
      "description": "YOUR DeepBook BalanceManager id (0x + 64 hex), from build_create_balance_manager_tx effects"
    }
  },
  "additionalProperties": false
}

build_create_balance_manager_tx

Create and share a DeepBook v3 BalanceManager owned by your address (needed for limit orders). Returns UNSIGNED tx bytes (simulated against mainnet). Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

read-only

Argument	Type	Description
sender*	string	YOUR Sui address (0x...). Public address only; never send a key.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "sender"
  ],
  "properties": {
    "sender": {
      "type": "string",
      "maxLength": 70,
      "minLength": 3,
      "description": "YOUR Sui address (0x...). Public address only; never send a key."
    }
  },
  "additionalProperties": false
}

build_limit_order_tx

Place a spot limit order on a DeepBook v3 pool from your BalanceManager (fees in the input coin, no DEEP needed). Validates tick/lot/min size. Optional deposit_first funds it in the same tx. No leverage. Returns UNSIGNED tx bytes (simulated against mainnet). Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

read-only

Argument	Type	Description
pool*	string	DeepBook pool BASE_QUOTE, e.g. SUI_USDC
side*	string
price*	number
sender*	string	YOUR Sui address (0x...). Public address only; never send a key.
quantity*	number	Base quantity
post_only	boolean	Post-only (maker): rejects if it would cross
expire_hours	number
deposit_first	boolean

build_swap_tx

Build base64 UNSIGNED Sui transaction bytes for a swap on the chosen venue, with the sender set to your address and an on-chain minimum-out from slippage_bps. The bytes are simulated against mainnet before return. You sign locally and submit yourself; nothing is executed by the desk. Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

read-only

Argument	Type	Description
to*	any
from*	string	Coin symbol: SUI, USDC, WAL, DEEP, CETUS
route	string	DeepBook only: route string from get_swap_quote, e.g. 'SUI_USDC -> WAL_USDC'
venue*	string	Venue from get_swap_quote (best.venue)
amount*	number	Amount of the from coin in human units, e.g. 2.5
sender*	string	YOUR Sui address (0x...). Public address only; never send a key.
simulate	boolean	Simulate the unsigned bytes against mainnet (no signature, nothing executed)

build_walrus_register_tx

Encode your public text (receipt/note) and build the Walrus register-blob tx paid in WAL by you; returns the blob_id. Then upload+certify locally (see walrus_store_guide). Refuses content that looks like a secret. Returns UNSIGNED tx bytes (simulated against mainnet). Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

read-only

Argument	Type	Description
epochs	integer
sender*	string	YOUR Sui address (0x...). Public address only; never send a key.
content*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "sender",
    "content"
  ],
  "properties": {
    "epochs": {
      "type": "integer",
      "default": 3,
      "maximum": 53,
      "minimum": 1
    },
    "sender": {
      "type": "string",
      "maxLength": 70,
      "minLength": 3,
      "description": "YOUR Sui address (0x...). Public address only; never send a key."
    },
    "content": {
      "type": "string",
      "maxLength": 64000,
      "minLength": 1
    }
  },
  "additionalProperties": false
}

check_holder

Check on chain (Sui mainnet) whether an address holds the The Secret Journals license token. Holders unlock extra read-only education tools (golden_path_market_read). Non-holders keep every basic tool. Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

read-only

Argument	Type	Description
address*	string	YOUR Sui address (0x...). Public address only; never send a key.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "maxLength": 70,
      "minLength": 3,
      "description": "YOUR Sui address (0x...). Public address only; never send a key."
    }
  },
  "additionalProperties": false
}

check_template_order

With a digest: verify your on-chain payment for an order and get the signed download link (plus add-ons). Without: return the order's status (and a fresh link once paid). The token is sent only to the store, in a header, and is never stored. Educational templates, not financial advice; no returns promised. All sales final, except where the law requires otherwise. You pay from your own wallet; this connector never holds keys or funds.

Argument	Type	Description
token*	string	Private order token from create_template_order (smt_...). Sent only to the store, in a header.
digest	string	Sui transaction digest of your exact USDC payment
order_id*	string	Order id from create_template_order (SM-...)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "order_id",
    "token"
  ],
  "properties": {
    "token": {
      "type": "string",
      "pattern": "^smt_[A-Za-z0-9_-]{43}$",
      "description": "Private order token from create_template_order (smt_...). Sent only to the store, in a header."
    },
    "digest": {
      "type": "string",
      "pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
      "description": "Sui transaction digest of your exact USDC payment"
    },
    "order_id": {
      "type": "string",
      "pattern": "^SM-[0-9A-HJKMNP-TV-Z]{10}$",
      "description": "Order id from create_template_order (SM-...)"
    }
  },
  "additionalProperties": false
}

create_template_order

Create a store order for one template. Returns the order id, a PRIVATE order token (shown once; keep it secret), the payee and the EXACT Sui USDC amount to send from your own wallet before the expiry. Nothing is charged by this call. Limited to a few orders per client per hour. Educational templates, not financial advice; no returns promised. All sales final, except where the law requires otherwise. You pay from your own wallet; this connector never holds keys or funds.

Argument	Type	Description
sku*	string	Template sku from list_templates, e.g. dune-saga-collection or fish-speakers
email	string	Optional receipt email

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "sku"
  ],
  "properties": {
    "sku": {
      "type": "string",
      "pattern": "^[a-z0-9-]{2,40}$",
      "description": "Template sku from list_templates, e.g. dune-saga-collection or fish-speakers"
    },
    "email": {
      "type": "string",
      "format": "email",
      "maxLength": 254,
      "description": "Optional receipt email"
    }
  },
  "additionalProperties": false
}

estimate_fees

Estimated DeepBook fee for a fill of qty at price as maker or taker, paid in the input token (rate x 1.25) versus in DEEP (base rate), using the live on-chain fee rates and the DEEP_USDC mid. Education/information only; not financial advice. Read-only public data, may be delayed or wrong. Free: 100 calls/day per client, then 0.002 USDC per call on Sui mainnet, prepaid in batches of about 0.01 USDC (the payment-required response gives an exact amount and a payment_token).

read-only

Argument	Type	Description
qty*	number	Base quantity
pool*	string	DeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)
role	string
price	number	Price; defaults to the current mid
payment_tx	string	Only after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)
payment_token	string	Only after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "pool",
    "qty"
  ],
  "properties": {
    "qty": {
      "type": "number",
      "description": "Base quantity",
      "exclusiveMinimum": 0
    },
    "pool": {
      "type": "string",
      "maxLength": 40,
      "minLength": 3,
      "description": "DeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)"
    },
    "role": {
      "enum": [
        "maker",
        "taker"
      ],
      "type": "string",
      "default": "taker"
    },
    "price": {
      "type": "number",
      "description": "Price; defaults to the current mid",
      "exclusiveMinimum": 0
    },
    "payment_tx": {
      "type": "string",
      "maxLength": 64,
      "minLength": 32,
      "description": "Only after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)"
    },
    "payment_token": {
      "type": "string",
      "pattern": "^plb_[A-Za-z0-9_-]{43}$",
      "description": "Only after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls"
    }
  },
  "additionalProperties": false
}

get_bm_fills

Fills (OrderFilled) where a given DeepBook BalanceManager was the maker or the taker in one pool, newest first: time, its side, price, qty, fee, tx. Public data; no keys. Education/information only; not financial advice. Read-only public data, may be delayed or wrong. Free: 100 calls/day per client, then 0.002 USDC per call on Sui mainnet, prepaid in batches of about 0.01 USDC (the payment-required response gives an exact amount and a payment_token).

read-only

Argument	Type	Description
pool*	string	DeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)
role	string
hours	integer	Look-back window in hours (default 168 = 7 days)
limit	integer
payment_tx	string	Only after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)
payment_token	string	Only after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls
balance_manager_id*	string	DeepBook BalanceManager object id (0x + 64 hex)

get_book_depth

Level-2 depth around mid read on chain from a DeepBook v3 pool (bids/asks [price, qty]). Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

read-only

Argument	Type	Description
pool*	string	DeepBook pool BASE_QUOTE, e.g. SUI_USDC
ticks	integer

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "pool"
  ],
  "properties": {
    "pool": {
      "type": "string",
      "maxLength": 30,
      "minLength": 3,
      "description": "DeepBook pool BASE_QUOTE, e.g. SUI_USDC"
    },
    "ticks": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1
    }
  },
  "additionalProperties": false
}

get_cetus_pool

Read-only Cetus CLMM pool state (coins, fee rate, tick spacing, liquidity, current tick, price) by pool_id, or discover the Cetus pools on the current from->to route. Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

read-only

Argument	Type	Description
to	any	Coin symbol: SUI, USDC, WAL, DEEP, CETUS
from	string	Coin symbol: SUI, USDC, WAL, DEEP, CETUS
pool_id	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "to": {
      "$ref": "#/properties/from",
      "description": "Coin symbol: SUI, USDC, WAL, DEEP, CETUS"
    },
    "from": {
      "type": "string",
      "maxLength": 10,
      "minLength": 2,
      "description": "Coin symbol: SUI, USDC, WAL, DEEP, CETUS"
    },
    "pool_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_desk_rhythm

The desk's weekly rhythm from https://thespicemelange.org/rhythm.json: focus pools, ladder windows, rung guidance, rebalance ranges, projects and lessons. The ed25519 signature is verified against the pinned release key, and the call fails closed if it doesn't match. Guidance only: no orders, no sizes in money, no promised returns. Not financial advice.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_indexer_status

Health and freshness of the public DeepBook indexer (status, latest checkpoint, server time). Use when data looks stale. Education/information only; not financial advice. Read-only public data, may be delayed or wrong.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_mid_price

Best bid, best ask, mid price and spread (abs and bps) for a DeepBook pool, plus last trade price. Education/information only; not financial advice. Read-only public data, may be delayed or wrong. Free: 100 calls/day per client, then 0.002 USDC per call on Sui mainnet, prepaid in batches of about 0.01 USDC (the payment-required response gives an exact amount and a payment_token).

read-only

Argument	Type	Description
pool*	string	DeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)
payment_tx	string	Only after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)
payment_token	string	Only after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "pool"
  ],
  "properties": {
    "pool": {
      "type": "string",
      "maxLength": 40,
      "minLength": 3,
      "description": "DeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)"
    },
    "payment_tx": {
      "type": "string",
      "maxLength": 64,
      "minLength": 32,
      "description": "Only after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)"
    },
    "payment_token": {
      "type": "string",
      "pattern": "^plb_[A-Za-z0-9_-]{43}$",
      "description": "Only after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls"
    }
  },
  "additionalProperties": false
}

get_ohlcv

OHLCV candles for a DeepBook pool (oldest first). Intervals: 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w. Volume is in the base asset. Education/information only; not financial advice. Read-only public data, may be delayed or wrong. Free: 100 calls/day per client, then 0.002 USDC per call on Sui mainnet, prepaid in batches of about 0.01 USDC (the payment-required response gives an exact amount and a payment_token).

read-only

Argument	Type	Description
pool*	string	DeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)
limit	integer	Number of candles (1-500, default 24)
end_time	any	Unix timestamp in SECONDS
interval	string
payment_tx	string	Only after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)
start_time	integer	Unix timestamp in SECONDS
payment_token	string	Only after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls

Input schema (JSON)

get_order_book

Order book for a DeepBook pool: top N price levels per side and cumulative liquidity (base qty and quote notional) within ±X% of mid. Education/information only; not financial advice. Read-only public data, may be delayed or wrong. Free: 100 calls/day per client, then 0.002 USDC per call on Sui mainnet, prepaid in batches of about 0.01 USDC (the payment-required response gives an exact amount and a payment_token).

read-only

Argument	Type	Description
pool*	string	DeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)
levels	integer	Price levels to return per side (1-100, default 10)
payment_tx	string	Only after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)
within_pct	array	Depth bands as % distance from mid, e.g. [0.5, 1, 2]
payment_token	string	Only after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "pool"
  ],
  "properties": {
    "pool": {
      "type": "string",
      "maxLength": 40,
      "minLength": 3,
      "description": "DeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)"
    },
    "levels": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "description": "Price levels to return per side (1-100, default 10)"
    },
    "payment_tx": {
      "type": "string",
      "maxLength": 64,
      "minLength": 32,
      "description": "Only after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)"
    },
    "within_pct": {
      "type": "array",
      "items": {
        "type": "number",
        "maximum": 50,
        "exclusiveMinimum": 0
      },
      "default": [
        0.5,
        1,
        2
      ],
      "maxItems": 6,
      "minItems": 1,
      "description": "Depth bands as % distance from mid, e.g. [0.5, 1, 2]"
    },
    "payment_token": {
      "type": "string",
      "pattern": "^plb_[A-Za-z0-9_-]{43}$",
      "description": "Only after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls"
    }
  },
  "additionalProperties": false
}

get_pool_params

Taker/maker fees, DEEP stake required, tick/lot/min size, whitelist/stable flags and vault balances for a DeepBook pool. Reads the live on-chain Pool object via Sui GraphQL; falls back to indexer pool-creation values if GraphQL is unavailable. Education/information only; not financial advice. Read-only public data, may be delayed or wrong. Free: 100 calls/day per client, then 0.002 USDC per call on Sui mainnet, prepaid in batches of about 0.01 USDC (the payment-required response gives an exact amount and a payment_token).

read-only

Argument	Type	Description
pool*	string	DeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)
payment_tx	string	Only after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)
payment_token	string	Only after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "pool"
  ],
  "properties": {
    "pool": {
      "type": "string",
      "maxLength": 40,
      "minLength": 3,
      "description": "DeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)"
    },
    "payment_tx": {
      "type": "string",
      "maxLength": 64,
      "minLength": 32,
      "description": "Only after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)"
    },
    "payment_token": {
      "type": "string",
      "pattern": "^plb_[A-Za-z0-9_-]{43}$",
      "description": "Only after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls"
    }
  },
  "additionalProperties": false
}

get_pool_stats

Scorecard-style stats for one pool over the last N hours: trade count, taker buy/sell split, base/quote volume, VWAP, average trade size, price range, current spread. Education/information only; not financial advice. Read-only public data, may be delayed or wrong. Free: 100 calls/day per client, then 0.002 USDC per call on Sui mainnet, prepaid in batches of about 0.01 USDC (the payment-required response gives an exact amount and a payment_token).

read-only

Argument	Type	Description
pool*	string	DeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)
hours	integer
payment_tx	string	Only after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)
payment_token	string	Only after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "pool"
  ],
  "properties": {
    "pool": {
      "type": "string",
      "maxLength": 40,
      "minLength": 3,
      "description": "DeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)"
    },
    "hours": {
      "type": "integer",
      "default": 24,
      "maximum": 72,
      "minimum": 1
    },
    "payment_tx": {
      "type": "string",
      "maxLength": 64,
      "minLength": 32,
      "description": "Only after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)"
    },
    "payment_token": {
      "type": "string",
      "pattern": "^plb_[A-Za-z0-9_-]{43}$",
      "description": "Only after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls"
    }
  },
  "additionalProperties": false
}

get_recent_trades

Most recent fills in a DeepBook pool (newest first): time, taker side, price, base and quote size. Optional time range. Education/information only; not financial advice. Read-only public data, may be delayed or wrong. Free: 100 calls/day per client, then 0.002 USDC per call on Sui mainnet, prepaid in batches of about 0.01 USDC (the payment-required response gives an exact amount and a payment_token).

read-only

Argument	Type	Description
pool*	string	DeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)
limit	integer	Number of trades (1-200, default 20)
end_time	any	Unix timestamp in SECONDS
include_tx	boolean	Include transaction digests (longer output)
payment_tx	string	Only after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)
start_time	integer	Unix timestamp in SECONDS
payment_token	string	Only after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls

get_swap_quote

Quote a spot swap between SUI/USDC/WAL/DEEP/CETUS and compare DeepBook v3 pools directly (direct or 2-hop) with the Cetus aggregator. Returns the best route, expected output, price impact and fees. Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

read-only

Argument	Type	Description
to*	any
from*	string	Coin symbol: SUI, USDC, WAL, DEEP, CETUS
amount*	number	Amount of the from coin in human units, e.g. 2.5
sender*	string	YOUR Sui address (0x...). Public address only; never send a key.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "from",
    "to",
    "amount",
    "sender"
  ],
  "properties": {
    "to": {
      "$ref": "#/properties/from"
    },
    "from": {
      "type": "string",
      "maxLength": 10,
      "minLength": 2,
      "description": "Coin symbol: SUI, USDC, WAL, DEEP, CETUS"
    },
    "amount": {
      "type": "number",
      "maximum": 1000000000000,
      "description": "Amount of the from coin in human units, e.g. 2.5",
      "exclusiveMinimum": 0
    },
    "sender": {
      "type": "string",
      "maxLength": 70,
      "minLength": 3,
      "description": "YOUR Sui address (0x...). Public address only; never send a key."
    }
  },
  "additionalProperties": false
}

get_swing_range

1h/4h/24h high-low range and realized volatility from hourly candles, a regime (CALM < 2%, ELEVATED 2-4%, HIGH_VOL > 4% 4h range) and a suggested ladder rung count (3/4/5). Information only, not a trading instruction. Education/information only; not financial advice. Read-only public data, may be delayed or wrong. Free: 100 calls/day per client, then 0.002 USDC per call on Sui mainnet, prepaid in batches of about 0.01 USDC (the payment-required response gives an exact amount and a payment_token).

read-only

Argument	Type	Description
pool*	string	DeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)
payment_tx	string	Only after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)
payment_token	string	Only after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "pool"
  ],
  "properties": {
    "pool": {
      "type": "string",
      "maxLength": 40,
      "minLength": 3,
      "description": "DeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)"
    },
    "payment_tx": {
      "type": "string",
      "maxLength": 64,
      "minLength": 32,
      "description": "Only after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)"
    },
    "payment_token": {
      "type": "string",
      "pattern": "^plb_[A-Za-z0-9_-]{43}$",
      "description": "Only after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls"
    }
  },
  "additionalProperties": false
}

get_volume

24h volume, high/low, last price and % change for one DeepBook pool, or the top pools by 24h quote volume if no pool is given. Set window_hours for a custom trailing window (single pool). Education/information only; not financial advice. Read-only public data, may be delayed or wrong. Free: 100 calls/day per client, then 0.002 USDC per call on Sui mainnet, prepaid in batches of about 0.01 USDC (the payment-required response gives an exact amount and a payment_token).

read-only

Argument	Type	Description
top	integer	When no pool is given: how many pools to return (default 10)
pool	string	DeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)
payment_tx	string	Only after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)
window_hours	integer	Trailing window in hours (default 24). Non-24 values need a pool.
payment_token	string	Only after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "top": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "When no pool is given: how many pools to return (default 10)"
    },
    "pool": {
      "type": "string",
      "maxLength": 40,
      "minLength": 3,
      "description": "DeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)"
    },
    "payment_tx": {
      "type": "string",
      "maxLength": 64,
      "minLength": 32,
      "description": "Only after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)"
    },
    "window_hours": {
      "type": "integer",
      "default": 24,
      "maximum": 720,
      "minimum": 1,
      "description": "Trailing window in hours (default 24). Non-24 values need a pool."
    },
    "payment_token": {
      "type": "string",
      "pattern": "^plb_[A-Za-z0-9_-]{43}$",
      "description": "Only after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls"
    }
  },
  "additionalProperties": false
}

golden_path_market_read

For The Secret Journals holders (checked on chain from 'address'): a compact market read across SUI, WAL and DEEP on DeepBook (mid, spread, 24h volume, 1h/4h/24h range and regime) plus the Golden Path pre-trade checklist. Education only, not a signal to buy or sell, no return claims. Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

read-only

Argument	Type	Description
address*	string	YOUR Sui address (0x...). Public address only; never send a key.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "maxLength": 70,
      "minLength": 3,
      "description": "YOUR Sui address (0x...). Public address only; never send a key."
    }
  },
  "additionalProperties": false
}

list_pools

List Sui DeepBook v3 spot pools with base/quote assets and trading params (tick, lot, min size in human units). Optional filter by asset symbol. Education/information only; not financial advice. Read-only public data, may be delayed or wrong. Free: 100 calls/day per client, then 0.002 USDC per call on Sui mainnet, prepaid in batches of about 0.01 USDC (the payment-required response gives an exact amount and a payment_token).

read-only

Argument	Type	Description
asset	string	Only pools containing this asset symbol, e.g. SUI or USDC
payment_tx	string	Only after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)
include_ids	boolean	Include pool object IDs and coin types (longer output)
payment_token	string	Only after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "asset": {
      "type": "string",
      "maxLength": 20,
      "minLength": 1,
      "description": "Only pools containing this asset symbol, e.g. SUI or USDC"
    },
    "payment_tx": {
      "type": "string",
      "maxLength": 64,
      "minLength": 32,
      "description": "Only after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)"
    },
    "include_ids": {
      "type": "boolean",
      "default": false,
      "description": "Include pool object IDs and coin types (longer output)"
    },
    "payment_token": {
      "type": "string",
      "pattern": "^plb_[A-Za-z0-9_-]{43}$",
      "description": "Only after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls"
    }
  },
  "additionalProperties": false
}

list_templates

List The Spice Melange Golden Path Grok Bot templates with prices in Sui USDC, versions and the no-checkout agent buying flow (from https://thespicemelange.org/store/catalog.json). Educational templates, not financial advice; no returns promised. All sales final, except where the law requires otherwise. You pay from your own wallet; this connector never holds keys or funds.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

read_walrus_blob

Read a public Walrus mainnet blob by id via the public aggregator (text, or base64 preview if binary; max 64 KB). Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

read-only

Argument	Type	Description
blob_id*	string
max_bytes	integer

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "blob_id"
  ],
  "properties": {
    "blob_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 20
    },
    "max_bytes": {
      "type": "integer",
      "default": 8000,
      "maximum": 64000,
      "minimum": 1
    }
  },
  "additionalProperties": false
}

wallet_setup_guide

Exact steps and @mysten/sui code for an agent to create its OWN Sui Ed25519 keypair locally, fund it with SUI (gas) and USDC, and sign/submit transactions itself. Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

walrus_store_guide

How to store a PUBLIC trade receipt or strategy note on Walrus mainnet with your own key (receipt schema + @mysten/walrus code). Non-custodial: the desk never sees or holds keys and never moves funds; it returns quotes and UNSIGNED transactions only. Spot only, no leverage. Education only, not financial advice.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "pool"
  ],
  "properties": {
    "pool": {
      "type": "string",
      "maxLength": 40,
      "minLength": 3,
      "description": "DeepBook pool name BASE_QUOTE, e.g. SUI_USDC (case-insensitive; '/' or '-' also accepted)"
    },
    "limit": {
      "type": "integer",
      "default": 24,
      "maximum": 500,
      "minimum": 1,
      "description": "Number of candles (1-500, default 24)"
    },
    "end_time": {
      "$ref": "#/properties/start_time",
      "description": "Unix timestamp in SECONDS"
    },
    "interval": {
      "enum": [
        "1m",
        "5m",
        "15m",
        "30m",
        "1h",
        "4h",
        "1d",
        "1w"
      ],
      "type": "string",
      "default": "1h"
    },
    "payment_tx": {
      "type": "string",
      "maxLength": 64,
      "minLength": 32,
      "description": "Only after the free tier: Sui transaction digest of your exact USDC payment for payment_token (see the payment-required response)"
    },
    "start_time": {
      "type": "integer",
      "maximum": 4102444800,
      "minimum": 1600000000,
      "description": "Unix timestamp in SECONDS"
    },
    "payment_token": {
      "type": "string",
      "pattern": "^plb_[A-Za-z0-9_-]{43}$",
      "description": "Only after the free tier: the private payment_token from the payment-required response; it holds your prepaid calls"
    }
  },
  "additionalProperties": false
}