Skip to content
Intear docs

Intear API

The Intear API has prices, token data, charts, trades, transfers, balances and holders for every fungible token on NEAR. All of it comes live over one WebSocket, updated after every block, and the parts that answer once are plain HTTP too.

wss://api.intea.rs/ws
https://api.intea.rs

It’s built for apps that show token data:

  • You ask for only the fields you show, so responses stay small.
  • Updates can come after every block, or only once a value has moved by a threshold you pick.
  • History and live updates join up exactly, so a list of trades never misses or repeats one.

What you can do

Section titled “What you can do”

Token lists

Every token’s price, liquidity, volume, supply and more, filtered and sorted, kept live with tokens.subscribe.

Charts

Candles in USD or NEAR, from 1 second to 1 week, with the latest candle updated live. See candles.

Trades and transfers

Every swap, transfer and transaction, as history and then live, filtered by token, account or size.

Wallets

An account’s balances, its activity across trades and transfers, and every token’s top holders.

Conventions

Section titled “Conventions”
  • Tokens are identified by their contract’s account ID, like wrap.near.
  • Amounts in a token’s smallest units (balances, supplies, trade amounts) are decimal strings, since they don’t fit in a JSON number.
  • price_usd is USD per whole token. price_usd_raw is the unscaled form the indexer works in: price_usd = price_usd_raw × 10^(decimals − 6).
  • Prices and USD values sent as strings have at most 30 significant digits and no trailing zeros. A token without a price has "0".
  • *_millis are Unix timestamps in milliseconds, and height is a NEAR block height.
  • In trades, native NEAR is always wrap.near. In balances and transfers it’s near, in yoctoNEAR.

Next steps

Section titled “Next steps”
QuickstartFetch tokens over HTTP, then keep a live token list over the WebSocket.
ConnectingHow messages, subscriptions and reconnects work.
Token fieldsEvery field a token has, and what it can be filtered and sorted by.