# Perps on Sol — full agent reference

Live Flash Trade perpetuals dashboard on Solana.

## Identity

| | |
|--|--|
| Name | Perps on Sol (POS) |
| URL | https://perpsonsol.com |
| Tagline | Live Flash Trade perps dashboard on Solana |
| Operator | Metasal / Milysec |
| Stack | Next.js static export on Cloudflare Pages (`flash-dashboard`) |
| Analytics | GA4 G-RWMY4ED27L |

## Purpose

Help traders and agents monitor Flash Trade perpetuals liquidity and open interest without running an indexer. Deep links out to Flash Trade for execution (referral-enabled).

## Primary user journeys

1. Land on homepage → see protocol TVL / OI / markets snapshot
2. Prices tab → filter by category (crypto, equities, commodities, forex)
3. Markets tab → sort by OI, long/short filter
4. Pools tab → expand pool for custody assets + capacity
5. Positions tab → paste Solana wallet → open positions + TP/SL/limit counts
6. CTA "Trade Perps" → https://www.flash.trade?referral=newuser

## API integration notes

All reads are public CORS-enabled HTTPS against `https://flashapi.trade` (no API key).

### Health shape (v2)

```json
{
  "status": "ok",
  "accounts": { "baskets": 0, "custodies": 0, "markets": 0, "pools": 0, "token_stakes": 0, "deposit_ledgers": 0 },
  "config": { "source": "cdn", "version": "…", "env": "…", "publishedAt": "…" }
}
```

Protocol open-position counts are **not** on health — aggregate `marketStats[].openPositions` and `openInterestUsd` from `/pool-data`.

### Positions

`GET /positions/owner/{base58}` returns a **map** `marketPubkey → PositionMetricsDto` with UI fields:
`marketSymbol`, `sideUi`, `entryPriceUi`, `sizeUsdUi`, `collateralUsdUi`, `pnlWithFeeUsdUi`, `leverageUi`, `liquidationPriceUi`, …

### Orders

`GET /orders/owner/{base58}` → map of markets with `limitOrders[]`, `takeProfitOrders[]`, `stopLossOrders[]`.

## Brand

- Cyan `#3AFFE1`, teal `#01E1E0`, yellow `#FFEB00`, bg `#0b0f14`
- Wordmark: P(cyan) O(white) S(cyan) + zap

## External links

- Trade: https://www.flash.trade?referral=newuser
- Docs: https://docs.flash.trade/flash-trade/
- API: https://flashapi.trade
- Program: FLASH6Lo6h3iasJKWDs2F8TkW2UKf3s15C8PMGuVfgBn
- Operator: https://metasal.xyz

## LLM / crawler files

- https://perpsonsol.com/llms.txt
- https://perpsonsol.com/llms-full.txt (this file)
- https://perpsonsol.com/robots.txt
- https://perpsonsol.com/sitemap.xml
- https://perpsonsol.com/og.png