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

patcito

PUT Dashboard - Burn Chart & FT/Capital Ratio

API Endpoints

Burn totals (in existing /tge/metrics response)

GET /tge/metrics

Response now includes ft_burns with per-chain cumulative totals and cross-chain total (chain_id: 0).

patcito

Swap Collateral — Frontend Integration Guide

Overview

Users can swap one collateral type for another within the FlyingTulip lending protocol. For example, swap USDC collateral to wS collateral (or any supported pair). The frontend signs an EIP-712 order and submits it to the executor API. The executor handles DEX routing and on-chain execution.

User Flow

1. User has collateral deposited in PositionsManager (e.g., USDC)
2. User signs an EIP-712 swap order specifying sellToken → buyToken