patcito

Spot API — changelog 2026-04-16 → 2026-04-17

Everything that landed on spot-trs-indexor in the last 24 h. Base URL on dev: https://api.opbalance.com/mm/spot. Paths below are as they appear through the ft-api proxy.

---

1. Structural overhaul (PR #12 — 9c85f96)

patcito

Spot API additions — health factor, liquidation prices, on-chain enrichment

Addendum to the main spec. These are new/populated fields on existing endpoints.

Base URL (dev): https://api.opbalance.com/mm/spot

---

GET /account/positions?address=<>&chainId=<> — 3 new fields

patcito

Creating leverage orders from the frontend

How to submit a leverage order from ft-usd2 against the executor. This is a condensed version of the server-authoritative reference script:

📂 Reference e2e (read this first): https://github.com/flyingtulipdotcom/leverage-executor/blob/f4cce0216e5412a70269d39fd699053d46985dbe/examples/e2e-order-flow.ts

It's a bun script that does the full flow against the running executor. Port the signing math from it; the one diff on frontend is that the user signs with their connected wallet (wagmi), not a private key

patcito

Leverage Orderbook API - Filler Guide

Endpoints

Method	Path	Description
GET	/leverage/orders/stream	SSE stream — real-time order events
GET	/leverage/orders?status=pending	Poll pending orders
POST	/leverage/orders/{id}/claim	Claim an order (30s TTL)
DELETE	/leverage/orders/{id}/claim	Release a claim

patcito

Flying Tulip Leverage Executor - Setup & Test Guide

Prerequisites

• Go 1.25+
• Docker (for PostgreSQL)
• Foundry (anvil, cast)
• Python 3 with web3, eth-keys, requests (for scripted testing)

Clone

patcito

API Updates (2026-03-30)

1. circuitBreakerLimitRaw — raw integer CB limit

Added to both /mm/lend and /mm/lend/cb endpoints. Use this instead of the float circuitBreakerLimit for MAX button / validation to avoid float rounding mismatches.

/mm/lend/cb

{
  "data": {

patcito

API Updates (2026-03-28)

1. Per-chain series in /status/ftusd/dashboard

Series data (price, ftUsdSupply, sftUsdSupply, apy) is now available per chain inside each chains[] entry.

GET /status/ftusd/dashboard?days=360&include_series=true&chain_ids=146

patcito

Lending API Updates (2026-03-26)

1. New: GET /mm/lend/cb?chain_id={chainId}&token={tokenAddress}

Lightweight circuit breaker polling endpoint. Use when a withdraw drawer is open to get real-time CB limits without fetching the full /mm/lend payload.

Params:

• chain_id — chain ID (e.g. 146)
• token — token contract address (e.g. 0x29219dd400f2Bf60E5a23d13Be72B486D4038894)

patcito

Lending Dashboard API Changes

Endpoint: GET /mm/lend

New: chains[].series

Each chain now includes a series object with daily historical data (last 30 days):

{

patcito

Frontend Changelog (main → staging)

New Features

PUT Dashboard

• FT Burn Chart — Cumulative FT burned over time with USD values, period selector (1w/1m/3m/6m/1y)
• FT/Capital Ratio Chart — Shows FT Value / Investment Value ratio over time
• Dashboard period dropdown and UI fixes
• stS token added to token config