patcito

FTUSD Dashboard API Documentation

This document covers the API endpoints for the FTUSD dashboard, including user balances, staking info, and reward previews.

---

Endpoints Overview

Endpoint	Method	Description

patcito

RPC Semaphore - Grafana Queries

Current Utilization (%)

rpc_semaphore_utilization

503 Rejections Rate

rate(rpc_semaphore_total_rejections[5m])

patcito

# PUT Dashboard APY Fields

## Endpoint

```
GET https://api.flyingtulip.com/status/put/dashboard
```

## Where to find APY

patcito

# PUT Dashboard API - USD Field Naming

## Field Naming Convention

For each USD value, there are now two fields:
- `*Usd` - Raw decimal value with 2 decimal places (e.g., `"28870000.00"`)
- `*UsdFormatted` - Formatted with K/M/B suffixes (e.g., `"28.87M"`)

This follows the existing pattern used throughout the API: `deployed` / `deployedFormatted`.

patcito

# API Fixes for Decimals and Yield Endpoints

## Summary

Two fixes have been deployed to address issues with yield data and USD conversion in the API.

---

## Fix 1: Weekly Yield USD Conversion and Decimals Handling

patcito

# PUT Dashboard API Change: Global Circuit Breaker Time to Reset

## Endpoint
`GET /status/put/dashboard`

## Change
Added two new fields to the chain-level `circuitBreaker` object:

| Field | Type | Description |
|-------|------|-------------|

patcito

ftUSD Dashboard API - Consolidated Endpoint

Overview

The /status/ftusd/dashboard endpoint has been updated to consolidate all ftUSD dashboard data into a single request. This provides:

1. Chain-specific contract data (ftUSD token, MintAndRedeem, StakingVault)
2. Per-chain metrics with 24h change percentages
3. Historical series data (supply, price, backing, APY)
4. Recent events (mints, redeems, staking activity)

patcito

PUT Dashboard API - Consolidated Endpoint

Overview

The /status/put/dashboard endpoint has been updated to consolidate all PUT dashboard data into a single request. This replaces the previous pattern where frontend had to:

1. Fetch /tge/metrics to discover strategies
2. Fetch /tge/metrics/series per strategy in parallel
3. Fetch /tge/yield for yield data
4. Process and convert all data to USD client-side

patcito

ftUSD Session & Preview API Guide

This guide covers the ftUSD preview endpoints for simulating operations and session management endpoints for session key delegation.

Base URL

Production: https://api.flyingtulip.com (or your configured API URL)

---

Preview Endpoints

patcito

ftUSD Dashboard API Guide

This guide covers the ftUSD dashboard endpoints for displaying user positions, stats, and historical events.

Base URL

Production: https://api.flyingtulip.com (or your configured API URL)

Endpoints

1. Get ftUSD Status