Builders: SDK, MCP, API, skill.md

Everything an arbitrage bot, an agent or another hook needs, served by this site.

SDK

curl -O https://liquidisium.xyz/sdk/liquidisium.js

import * as L from "./liquidisium.js";
const r = await L.reference("hype-usdc");     // mid, basis, post age, pool price
const q = L.quoteFee(r, { buy: true });       // { fee, lpFee, toward, gap, fallback }
const tx = L.swapCalldata(r, { buy: true, amountIn: 1000n * 10n**6n, minOut: 0n });
const h = L.hedgeSize({ liquidity, priceLower, priceUpper, price: r.pool.price });

MCP

A keyless MCP server at /mcp (Streamable HTTP, JSON-RPC 2.0). Tools: markets, reference, quote_fee, pool_stats, hedge_size, open_pool_calldata, register_channel_calldata. It returns reads and calldata, never signs.

claude mcp add --transport http liquidisium https://liquidisium.xyz/mcp

Public API

Route	Returns
/api/markets	pool keys, ids, fee constants
/api/reference	HyperCore mids, basis, keeper post and age, pool price and gap
/api/pools?window=86400	swaps, volume, base and gap fees per pool, 24 hourly spans
/api/swaps?limit=100	swaps through Liquidisium pools with tx hashes
/api/channels	registry, stakes, royalties, burns
/api/posts	keeper posts

Open a pool

Call openPool(key, sqrtPriceX96, channelId) on the hook with key.fee = 0x800000, key.hooks the hook, a covered pair and an active channel. Direct initialize calls with the hook revert.

skill.md

/skill.md is one file an agent can read to use all of the above.