API, MCP and SDK

Public API

Path	Returns
`GET /api/gauge`	value, target, progress, phase, totals, volumes
`GET /api/auction`	HIP-1 start, current price, floor, end
`GET /api/journal?limit=`	decoded events, newest first
`GET /api/quote?side=&amountWei=`	quote from the hook
`GET /api/tx?kind=buy&hype=&to=`	unsigned transaction

MCP server

Streamable HTTP at /mcp, no key. Tools: gauge_state, auction_state, quote, buy_calldata, sell_calldata, journal, volume.

curl -s -X POST https://yieldium.app/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"gauge_state"}}'

SDK

import { Yieldium } from "https://yieldium.app/sdk/yieldium.js";
const y = new Yieldium("https://yieldium.app");
const { percent } = await y.progress();

Agents can read skill.md for the same thing in one file.