# Coin Universe (`market_coins`)

> Every symbol the market-data providers can answer for, so your agent knows what it can ask about before it asks.

- Category: Market data
- MCP tool: `market_coins`
- REST: `GET /market/coins`
- x402 price: $0.01 per call (USDC on Base)
- HTML: https://www.f1ow.com/docs/tools/market_coins

## What it does

Lists the coin symbols available from the market-data provider

## Parameters

None.

## Call it

### cURL

```bash
curl "https://mcp.f1ow.com/v1/market/coins" \
  -H "Authorization: Bearer $F1OW_API_KEY"
```

### MCP

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "market_coins",
    "arguments": {}
  }
}
```

### TypeScript

```ts
const res = await fetch("https://mcp.f1ow.com/v1/market/coins", {
  headers: { Authorization: `Bearer ${process.env.F1OW_API_KEY}` },
});
const data = await res.json(); // the tool's result as JSON, typed in the OpenAPI spec
console.log(data);
```

### Python

```python
import os, requests

res = requests.get(
    "https://mcp.f1ow.com/v1/market/coins",
    headers={"Authorization": f"Bearer {os.environ['F1OW_API_KEY']}"},
)
data = res.json()  # the tool's result as JSON, typed in the OpenAPI spec
print(data)
```

### WebSocket

```jsonc
// wss://mcp.f1ow.com/v1/ws — subprotocol "jsonrpc-2.0", Authorization: Bearer <key>
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "market_coins",
    "arguments": {}
  }
}

// Or push a fresh result whenever it changes (minimum interval 15 s)
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "subscriptions/subscribe",
  "params": {
    "name": "market_coins",
    "arguments": {},
    "intervalSeconds": 60
  }
}
```

### x402

```bash
# No account: the first call answers 402 with a PAYMENT-REQUIRED challenge;
# an x402 client pays it in USDC on Base and retries.
curl "https://mcp.f1ow.com/x402/v1/market/coins"
```

## Sample response

Captured 2026-11-13. The JSON is what REST and WebSocket return and the `structuredContent` of an MCP call (trimmed):

```json
{
  "coins": [
    "BTC",
    "ETH",
    "SOL",
    "HYPE",
    "XRP",
    "ZEC",
    "… 18802 more"
  ],
  "generatedAt": "2026-11-13T08:05:40.5166051+00:00"
}
```

Over MCP the text report a model reads comes with it:

```text
BTC, ETH, SOL, HYPE, XRP, ZEC, XAU, NVDA, BNB, SPCX, DOGE, XAUT, SNDK, NEAR, SOXL, XAG, GOOGL, CL, SKHYNIX, MU, SUI, SP500, LINK, UNI, ENA, ADA, ASTER, LIT, AVAX, SKHY, SILVER, LTC, XMR, BRENTOIL, PAXG, INTC, CRCL, GOLD, TRX, PEPE, WLD, QQQ, WLFI, SKHX, AAVE, XYZ100, TAO, BZ, BCH, MSTR, AAPL, ANTHROPIC, ONDO, XLM, TSLA, ARB, PUMP, AMD, 1000PEPE, ZRO, NBIS, DOT, HBAR, DRAM, KORU, INJ, TRUMP, XPL, GRAM, FIL, SPY, VVV, META, ANT, FARTCOIN, MSFT, AERO, ETHFI, FF, ICP, PENGU, SOXS, CRV, AKE, BTW, NATGAS, UKOIL, UNITREE, STRK, APT, ETC, PONS, PIEVERSE, TIA, USELESS, GRASS, POL, FET, ATOM, MON, AMZN, QNT, LDO, EWY, COIN, CBRS, ARIA, OPENAI, VIRTUAL, OP, SNXX, TQQQ, LITE, WIF, CAP, JUP, MRVL, CXMT, SPX500, PENDLE, USOIL, JPY, AVGO, STRC, kPEPE, DASH, NVIDIA, RENDER, SEI, CRWV, SAMSUNG, KITE, SMSN, JCT, PUMPFUN, CC, ORCL, MORPHO, IDOL, MNT, TSM, ZHIPU, KAS, ALGO, HOOD, AGT, BABA, INIT, 币安人生, EUR, RBLX, COPPER, PYTH, MRNA, SOON, BARD, EVAA, BEAT, SKY, 1000BONK, MEGA, XPT, SHIB, BAT, IBM, USDC, SPX, AAOI, WDC, SAND, VET, MUBARAK, ONE, CASHCAT, CHIP, STX, CAKE, WBT, JTO, NIGHT, LLY, PLTR, NAS100, CAD, BLESS, GBP, ARX, RKLB, OKB, EIGEN, MAGMA, SQQQ, 1000SHIB, BR, ORDI, PROM, INTW, EDGE, Q, 牛来, ZAMA, IREN, LAB, TRB, BMNR, NFLX, XPD, BE, TA, UAI, W, BEAMX, AKT, PLUME, KAITO, S, MUU, AR, COMP, AIN, DELL, JST, LYN, 龙虾, COHR, BRKB, APR, COST, H, PURRDAT, OPG, BTCDOM, IMX, GALA, ERA, ICNT, BGB, HUMA, CRO, QCOM, SYRUP, AIOT, JELLYJELLY, NIL, ZHONGJI, MAGIC, MINIMAX, ARM, KAVA, SUN, APE, CFX, TWT, RIVER, 0G, CHF, LUNC, HOME, GRVT, LSK, ZEN, SIREN, TAG, AXS, TRUTH, ACE, ALLO, DYDX, ZK, IRYS, MVLL, ESPORTS, HANA, CHZ, KGEN, LIGHT, BOME, SOPH, ENS, MANA, JASMY, AMAT, B2, EWZ, ZEST, BAN, FOLKS, O, TRADOOR, MET, CT, RUNE, MARSCOIN, GIGGLE, SKYAI, PURR, HNT, BSB, XPIN, SIGN, KIOXIA, POPCAT, MYX, KSTR, RAVE, B, RAY, SENT, BULLA, AXTI, POWER, BLUR, SKR, PIPPIN, FLOKI, BIO, M, MINA, OPEN, APP, PREDICT, ASML, BEAM, RSR, DOOD, BANK, ZEREBRO, MA, SMCI, CYBER, STABLE, BERA, GRT, ZBT, TUT, FORM, GLW, BLUAI, GPS, DUSK, SUSHI, DOS, ARC, MERL, US100, BNC, TTWO, BTR, DEXE, SYN, XTZ, AVNT, HMSTR, ARKM, IOTA, ELSA, COAI, HK0700, ON, ALCH, TRIA, BASED, ALT, OURA, EGLD, ATH, PEOPLE, LINEA, BIRB, PNUT, MANTA, ZORA, TRY, AT, ROSE, MMT, LUMIA, US, UVXY, BMT, BBX, PARTI, NOK, SMH, OGN, COINBASE, COTI, TLT, USUAL, TAKE, BANANAS31, ONG, NAORIS, NXPC, BX, NEO, CKB, A, REZ, US30, THETA, KOMA, ZETA, VELVET, ACU, AIA, QTUM, CVX, TENCENT, SAGA, SAPIEN, ZKSYNC, COLLECT, USAR, TRUMPSOL, AIO, GMX, AMDSTOCK, ACT, NG, NOW, NMR, IOST, TESLA, UB, MOODENG, RIF, ZIL, KMNO, PHAROS, SNX, IO, ORCA, TURBO, RE, HYUNDAI, XAN, PHA, SKHYNIXUSD, WTI, ASTS, NOT, FLUID, BSV, MOONSHOT, WAL, PROVE, ESP, GPRO, SNOW, TRUMPOFFICIAL, GENIUS, DNA, SUPER, GMT, LONGXIA, ORDER, XAI, HD, RVN, GWEI, LPT, LA, BILL, AMC, FIGHT, 4, BRETT, CLANKER, SAHARA, FILECOIN, EURUSD, STBL, ACN, MOVR, KAIA, UNH, DEEP, 1INCH, GTC, CYS, BABY, CTR, STAR, HAEDAL, PRL, SKUU, kBONK, BICO, RESOLV, DODOX, SPK, EDU, GRIFFAIN, 2Z, CELO, C, SOMI, T, DE, GME, PDD, HOT, ARK, CLO, TSEM, SWARMS, ENJ, BAC, ISRG, NVDL, SLX, NET, OL, AWE, GIGADEV, ENSO, SXT, SHIB1000, ROBO, MELANIA, API3, MASK, LISTA, XNY, TNSR, CFG, SAFE, YGG, PLAY, RED, OPN, DGAI, LASERTEC, IONQ, HK1810, YFI, EDEN, KAT, 1000RATS, FHE, GUA, FLOW, ONT, ADBE, FOGO, NOM, AIXBT, SSV, AVA, GOAT, TMF, RAYSOL, AUCTION, MSTU, RLC, EWT, ID, KO, INX, AEVO, SOLV, NEM, KSM, XDP, TQQQX, AXIS, XTI, WMT, CHILLGUY, APEX, FLOCK, SPACE, SONIC, HEMI, AZTEC, EWJ, 1000FLOKI, CDNS, RAYDIUM, XLE, MEME, NKE, CATI, MEW, VLO, SQD, NGAS, DRIFT, IN, SHAZ, FLUX, ZRX, AGLD, NVO, ALAB, STO, ANIME, SAMSUNGUSD, ME, MOVE, ZKP, KERNEL, DYM, RDDT, JP225, HIMS, ALICE, XOM, SHELL, WET, EUL, VST, METIS, MCD, TREE, NEIRO, AVAAI, NVDAX, YAGEO, BB, COW, JPM, BOT, TAC, HEI, WOO, AXL, SOXX, STONK, POWR, ONDS, GUN, 哈基米, PORTAL, FLNC, CROSS, SONY, CORE, TOWNS, QNTX, RECALL, VTHO, TRUST, UBER, G, BAND, PIXEL, XIAOMI, LRCX, 1000LUNC, CRDO, COOKIE, TAIKO, MAVIA, ETHBTC, 我踏马来了, BREV, AEON, HOLO, F, WCT, GAS, CSOPSKHYNIX2L, kSHIB, URNM, UMA, GLM, SKDD, POPMART, BROCCOLI, ZM, HYPER, PUNDIX, SFP, XCU, TLM, KII, PROS, DATAIP, BONK, XDC, VANA, LAYER, BLEND, GS, ANKR, CTSI, MANTRA, BKNG, SKL, MIRA, ACH, DATA, XVG, OKTA, PLATINUM, BSP, OSCR, BIGTIME, ALPINE, FTNT, RARE, MTSI, BROCCOLIF3B, MAV, CIEN, IWM, C98, CGPT, ASTR, 1000CAT, ARPA, STXX, DOGS, NDX100, LUNA, CRWD, YB, WAVES, BANANA, ETHW, US500, V, STEEM, RIVN, THE, SLB, KOSPI, KUAISHOU, KNC, NES, GEV, AGPU, CVC, POLYX, TER, CP, ZKC, MOCA, OG, TST, BA, CAPETH, SHOP, IOTX, FLR, UP, NCCOGOLD2USD, ILV, VRT, GDX, FWDI, USDBRL, ASR, GGLL, SOFI, SECZ, FRAX, 1MBABYDOGE, HPQ, NCCO1OILWTI2USD, AUD, NCSINASDAQ1002USD, USDJPY, XTEN, NCCOXAG2USD, CARV, SOFTBANK, LNG, SPORTFUN, NEWT, MTL, CRM, AIGENSYN, BRL, AEHR, CETUS, GOOGLX, 1000000MOG, 1000XEC, MSTRX, RAM, TWST, CHR, SCR, DRV, IBIT, BAS, LQTY, HIVE, BYD, CSCO, DIA, PANW, AZN, KLAC, VELO, SPCXX, CAT, XCN, TZA, HPE, TURTLE, CSTOCK, DJT, SPYX, TSLL, FIDA, LYTE, SLP, CATSTOCK, DOLO, EBAY, XVS, LUNA2, RPL, 1000SATS, KR200, DIS, MEITUAN, STXSTOCK, OFC, SHEIN, USTC, MARA, ALLINDEX, OKLO, RECRUIT, BNT, SPELL, CELR, DHR, WAXP, INTU, DKNG, MEDIATEK, APD, WEN, NVD, TEM, MONAD, BEL, RTXSTOCK, IBKR, JOE, JIO, RONIN, BROCCOLI714, FUTUON, 1000000BABYDOGE, 1000CHEEMS, 10000SATS, TOSHI, XIAOMIHKD, DISCO, GE, FLY, PEAQ, RDW, XBI, PALLADIUM, GIGADEVICE, 4STOCK, SBUX, RON, PENG, GANG, RLS, FUTU, FLEX, SAMSUNGEM, MP, QQQX, POLYMARKET, GBPUSD, RGTI, XBR, RATS, NAVER, PYPL, BP, ANSEM, ZKJ, TXN, CTK, MELI, BWET, SI, USDKRW, CYPH, ADVANTEST, LIN, TENCENTHKD, SANTOS, JD, KCS, MRK, GT, LGELECTRONICS, 10000NEX, APLD, DDOG, MUSTOCK, HANWHAAERO, OXY, QUANT, TWLO, REDSTONE, CATE, HLT, FLOAT, GLDX, AAPLX, NCSKAPP2USD, NCSKBNY2USD, NCSKHL2USD, NCSKTWLO2USD, NCSKMETA2USD, NCSKOSS2USD, NCSKTBTUSDT, NCSKLYTE2USD, NCSKHAL2USD, NCSKSWKS2USD, NCSKTSLL2USD, NCSKTT2USD, NCSKSMCI2USD, NCSKSBUX2USD, NCSKCVE2USD, NCSKSPOT2USD, NCSKTM2USD, NCSKAPH2USD, NCSKSOXS12USD, NCSKBWET2USD, CSOPSAMSUNG2L, NCSKXBI2USD, NCSKBLK2USD, NCSKNXPI2USD, NCSKJD2USD, NCSKVRT2USD, NCSKMSFT2USD, NCSKMXL2USD, JAGENT, NCSKPWR2USD, NCSKFISV2USD, NCSKCLF2USD, NCSKLITE2USD, NCSKDXYZ2USD, NCSKNBIS2USD, NCSKOKTA2USD, NCSKAZN2USD, NCSKEIDO2USD, NCSKCOST2USD, NCSKARKK2USD, NCSKPCVX2USD, NCSKMETU2USD, NCSKMVLL2USD, NCSKAMC2USD, NCSKLUNR2USD, NCSKBULL2USD, KNOTS, NCSKFSLY2USD, NCFXGBP2CHF, NCSIRUSSELL20002USD, NCSKRGTI2USD, NCSKITA2USD, NCSKTTMI2USD, NCSKMRNX2USD, NCSKNEM2USD, NCSKMA2USD, NCSKUPS2USD, NCSKVICR2USD, NCSKASML2USD, NCSKFDX2USD, NCSKSYK2USD, NCSKNOC2USD, NCSKTZA2USD, NCSKCIFR2USD, NCSKDIA2USD, NCSKMP2USD, NCSKDHI2USD, NCSKGDDY2USD, NCSKCRDO2USD, NCSKSNOW2USD, NCSKTE2USD, NCSKURI2USD, NCSKUSDE2USD, NCSKMMM2USD, NCSKJNJ2USD, NCSKTER2USD, NCSKSTM2USD, NCSKULTA2USD, NCSKFPS2USD, NCSKUGL2USD, NCSKAEP2USD, NCSKACN2USD, NCSKEL2USD, NCSKCONL2USD, NCSKBBD2USD, NCSKTSLA2USD, NCSKCAI2USD, NCSKTQQQ2USD, NCSKFRMI2USD, NCSIKOSPI2USD, NCSKMAGS2USD, NCSKPOLYMARKET2USD, NCSKNETFLIX2USD, NCSKXME2USD, NCSKORCX2USD, USDEX, NCSKADI2USD, NCCOXAUZAR2USD, NCSKBOT2US
…
```

## Related tools

- [Spot & Perp Quotes](https://www.f1ow.com/docs/tools/market_quotes) — Spot and perp mark side by side, with funding, open interest, long/short ratio and the day's liquidations. Five providers merged into one snapshot, cached for thirty seconds.
- [Candles](https://www.f1ow.com/docs/tools/market_candles) — Spot or perpetual OHLCV candles with venue routing and fallback, for the timeframes your analysis needs. For months of paged candles or derivatives series, use Bulk History.
- [Bulk History](https://www.f1ow.com/docs/tools/market_history) — Paged spot/perp candles, aggregate open interest, funding or long/short liquidations. Up to 1,000 rows per call with a backward-page cursor, explicit time bounds and a forming-row flag — for historical research and backtests.
- [Market Overview](https://www.f1ow.com/docs/tools/market_overview) — The global frame in one read: total market cap, BTC and ETH dominance, Fear & Greed, Altcoin Season.