Build against typed boundaries

• GET/api/status

  Machine-readable build and capability status. The source of truth behind every status chip.

  Returns

  { build, capabilities, adapters[], protocolResearch[] }

• GET/api/tokens

  Token listings with server-side filtering, sorting and pagination.

  Params

  tab, search, sort, dir, minMarketCap, maxMarketCap, minRewardRate, verifiedOnly, limit, offset

  Returns

  { items[], total, generatedAt, source }

• GET/api/tokens/{id}

  One token with full detail and its immutable fee split.

  Returns

  TokenDetail

• GET/api/tokens/{id}/candles

  OHLCV series. Never longer than the token has existed.

  Params

  tf = 5m | 1h | 4h | 1d

  Returns

  Candle[]

• GET/api/tokens/{id}/trades

  Recent trades. Public data by definition on Solana today.

  Params

  limit ≤ 100

  Returns

  Trade[]

• GET/api/tokens/{id}/holders

  Holder table with time-weighted eligibility.

  Returns

  Holder[]

• POST/api/quote

  SOL → XMR quote with expiry, per-hop route disclosure and fee breakdown.

  Params

  { fromAmountSol: number }

  Returns

  ConversionQuote

• POST/api/private-address

  Bech32/Bech32m validation. The address is checked and discarded — never logged, stored or echoed.

  Params

  { address: string }

  Returns

  PrivateAddressCheck

• POST/api/launch/preview

  Validates a launch configuration and returns the exact immutable terms plus a cost estimate. Mints nothing — there is no create endpoint.

  Params

  LaunchConfig

  Returns

  { valid, mintingEnabled, terms, costEstimate, warning }

• GET/api/rewards

  Accruals, positions and epoch history for an address.

  Params

  wallet = <solana address>

  Returns

  { accruals[], epochs[], positions[] }

curl -s localhost:4100/api/status | jq '.data.capabilities'

curl -s 'localhost:4100/api/tokens?tab=graduating&sort=rewards&dir=desc&limit=5' \
  | jq '.data.items[] | {symbol, rewardRate, curveProgress}'

curl -s localhost:4100/api/private-address \
  -H 'content-type: application/json' \
  -d '{"address":"t1RwbKka3QmQ2fJ2AxHLGWRrKEHqmYm4Eay"}' | jq '.data'