NextFly / Documentation

Clarity, documented.

The fields, formulas, and sources behind the NextFly market workspace.

Overview

A connected market workspace.

NextFly brings public market observations into a single interface: crypto quotes, a tracked token’s pool metrics and a capital lens. All market views are read-only.

The token terminal identifies its asset using the configured contract and the market provider’s token symbol. Updating the contract changes the market being tracked.

Data definitions

Give each metric its own meaning.

  • Token price: the selected base asset’s USD price.
  • Market cap: the provider’s reported market capitalization. An absent value is not replaced by FDV.
  • FDV: fully diluted valuation, shown separately.
  • Liquidity: total USD liquidity reported for the selected pair.
  • 24h volume and trades: selected-pair activity; trades are buys plus sells.
DEX Screener supplies observations for the selected pair.
Measurement method

Simple ratios. Stated assumptions.

The capital lens uses the selected pool’s latest available snapshot. Enter a USD position to compare it with the pool’s reported liquidity.

Position / liquidity (%) = 100 × positionUSD / liquidityUSD
Liquidity / market cap (%) = 100 × liquidityUSD / marketCap
24h turnover (×) = volume24hUSD / liquidityUSD

The curve plots the first ratio for position sizes from $100 to $100,000, using a logarithmic position axis. Its points share one liquidity snapshot. It is not a price chart or a time series.

A pool’s reported value is not executable depth. These calculations do not estimate an execution price, slippage, yield, or a recommended position size. Ratios remain unavailable if a required value is missing or its denominator is zero.
API reference

Read the same observations as the interface.

Endpoints accept GET requests. No wallet is required. Responses may be cached for 45 seconds; the interface refreshes once per configured interval while visible. Provider failures can yield a partial response or a timestamped older snapshot.

GET /api/markets ↗

BTC, ETH, USDT, and optional TSLA observations. Quote fields: symbol, price, change24h, asOf, source, and status. The response includes fetchedAt.

GET /api/token ↗

Contract identity, selected-pair metrics, provider names, and fetchedAt. Market values appear under market. Fields without observations are null.

GET /api/status ↗

Project configuration and provider credential availability. Credential values are never returned.

curl https://YOUR_SITE/api/token
curl https://YOUR_SITE/api/markets

Use your deployed site’s hostname. Requests are subject to provider availability and rate limits; these endpoints carry no execution or availability guarantee.

Sources & freshness

A timestamp is part of the observation.

CoinGecko supplies crypto prices, 24-hour changes, and source timestamps. If its request fails, Coinbase spot quotes supply prices; the fallback does not invent a 24-hour change or a quote timestamp. Tesla uses Finnhub when configured, with Yahoo Finance and Stooq as keyless fallbacks. Equity changes compare with the previous close when that value is supplied. The card shows the provider and quote time or source date; a freshly fetched response can still contain the last available session quote. Stooq does not supply a timezone-qualified timestamp or a previous close in this feed, so those values stay unavailable.

Fetched means when NextFly retrieved a response. Source time means when a provider dated its quote. DEX pair snapshots and Coinbase spot responses may not provide a quote timestamp. Missing or failed sources are identified in the interface.

Pool selection matches the configured chain and base token, then chooses the highest reported USD liquidity unless a valid pair address is pinned. This is a selected-pool view, not an aggregate of every venue.

Project configuration

One file for the essentials.

Edit config/project.json to change the name, browser title, description, tracked contract, network, social URLs, and refresh interval. Social fields left blank display Coming soon. Redeploy after editing; public configuration is generated from this file.

config/project.json
  name, shortName, title, description
  token.address, token.chainId, token.chainName
  token.explorerBaseUrl, token.pairAddress
  socials.x, socials.telegram, socials.github
  socials.discord, socials.email
  defaultTheme, market.refreshSeconds

Optional quote-provider credentials belong in server environment variables: FINNHUB_API_KEY and COINGECKO_DEMO_API_KEY. Never put credentials in the public project configuration.

Research priorities

Deepen the observation before the claim.

Next research priorities are historical data collection, venue coverage checks, liquidity concentration, and comparisons across market conditions. Any future forecasting method needs an explicit target, an evaluation window, and evidence of performance outside its training data.

Production alert delivery, signed attestations, a public outcome registry, and automated execution are separate research and engineering tracks. The current workspace provides observations and descriptive calculations.

Source documentation

Inspect the foundations.

DEX Screener API ↗CoinGecko Simple Price ↗Coinbase Prices ↗Finnhub Quote API ↗Yahoo Finance — Tesla ↗Stooq — Tesla quotes ↗

These are data sources, not claimed partnerships. The product approach is NextFly’s own.