@fluidwallet/fluid-ticker

Fluid Wallet Ticker API client — crypto spot prices powered by Fluid Wallet, free tier included.

Try it instantly — one command demo

npx @fluidwallet/fluid-ticker@latest
cd fluid-ticker-demo
npm run dev

Scaffolds a Vite + React app with live crypto prices at localhost:5173. No API key needed.

Install in an existing project

npm install @fluidwallet/fluid-ticker

Quick start

import { FluidTicker } from '@fluidwallet/fluid-ticker';

// Explorer tier — 100 free calls/month, no key needed
const ticker = new FluidTicker();

const { data } = await ticker.getPrice('bitcoin');
console.log(data.usd); // e.g. 94250.12

// Batch prices
const { data: prices } = await ticker.getPrices(['bitcoin', 'ethereum', 'solana']);

With API key (paid tiers)

const ticker = new FluidTicker({ apiKey: 'fw_ticker_your_key_here' });

// Build tier+ — markets, trending, search, global
const { data: markets } = await ticker.getMarkets({ perPage: 25 });
const { data: trending } = await ticker.getTrending();
const { data: results } = await ticker.search('pepe');

// Ship tier+ — historical chart data
const { data: chart } = await ticker.getMarketChart('bitcoin', 30);
console.log(chart.prices); // [[timestamp, price], ...]

API reference

| Method | Tiers | Description | |---|---|---| | getPrice(coinId, currency?) | All | Single coin spot price | | getPrices(coinIds[], currency?) | All | Batch spot prices | | getMarkets(options?) | Build+ | Paginated market data | | getTrending() | Build+ | Trending coins | | search(query) | Build+ | Search by name or symbol | | getMarketChart(coinId, days?) | Ship+ | OHLC / price history | | getGlobal() | Build+ | Global market stats |

Pricing

| Tier | Price | Calls/mo | Rate | |---|---|---|---| | Explorer | Free | 100 | 1/sec | | Spark | $0.10 | 500 | 1/sec | | Build | $1 | 10,000 | 5/sec | | Ship | $4 | 50,000 | 20/sec | | Scale | $9 | 125,000 | 50/sec | | Growth | $49 | 100,000 | 50/sec | | Enterprise | $199+ | Custom | Custom |

Pay in USDC · Get your key at fluidnative.com/ticker

Error handling

import type { FluidTickerError } from '@fluidwallet/fluid-ticker';

try {
  const result = await ticker.getPrice('bitcoin');
} catch (err) {
  const e = err as FluidTickerError;
  if (e.status === 429) {
    console.log('Rate limit hit. Retry after', e.retryAfterMs, 'ms');
    console.log('Upgrade at', e.upgradeUrl);
  }
}

Links

• npm: npmjs.com/package/@fluidwallet/fluid-ticker
• GitHub: github.com/fluidbase9/fluid-ticker
• Docs & keys: fluidnative.com/ticker
• Fluid Wallet: fluidnative.com