Skip to content
Dotstronic

Developers

Readable for humans. Structured for applications.

Every page of this site is built on the JSON routes below. They are read-only, need no key, and return each result in one envelope that says where it came from. Only routes that exist are listed here.

Overview

  • Base URL: https://www.dotstronic.space. All routes are under /api and answer application/json unless noted.
  • Network: Solana mainnet-beta only. The server confirms the cluster by genesis hash before reading.
  • No authentication, no wallet. The routes are read-only and send no transactions.
  • Addresses are validated as base58, 32 bytes. Program-derived addresses are accepted; being off-curve is not an error.
curl https://www.dotstronic.space/api/token/JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN/market

Provenance envelope

A data panel is never a bare value. Each one is wrapped in the same envelope, and a route that serves several panels returns several envelopes side by side (for example the chain reading and the index record of a token).

{
  "value": { "priceUsd": 0.2549, "selectedLiquidityUsd": 1648743.81, "poolsListed": 20, "pools": [ … ] },
  "unit": "USD",
  "source": "GeckoTerminal API",
  "sourceUrl": "https://apiguide.geckoterminal.com",
  "method": "GET /networks/solana/tokens/{mint}/pools",
  "observedAt": null,
  "fetchedAt": "2026-11-18T02:50:46.520Z",
  "slot": null,
  "coverage": "20 pools listed by GeckoTerminal (first page, at most 20). Price is the price in the pool with the largest reserve. …",
  "status": "partial",
  "methodologyVersion": "dotstronic-m1",
  "evidence": [ { "kind": "pool", "value": "C8Gr6AUu…", "label": "meteora JUP / SOL" } ],
  "note": "The provider’s first page was full, so more pools may exist than are listed."
}
Envelope fields
FieldMeaning
valueThe data, or null when it could not be read. null is never replaced by zero or by an example.
unitWhat the value is measured in: “USD”, “raw base units”, “USD at trade time”, “findings”.
sourceWho reported it. For chain reads, the RPC host name only: no URL or key is ever returned.
methodThe RPC call or provider endpoint used.
observedAtWhen the chain or the provider observed the data. null when the source does not say.
fetchedAtWhen this server fetched it.
slotSlot of a chain read. Always null for off-chain market data: no slot is invented.
coverageOne sentence on what the value covers and what it leaves out.
statusavailable, partial, stale, unavailable, unsupported, error
methodologyVersionThe methodology the value was computed under. Do not compare values across versions without reading what changed.
evidenceReferences behind the value: transaction signatures, addresses, pools or documentation links.
noteWhy the status is what it is, when it is not simply available.

Token amounts are decimal strings of base units (for example "6861485663384978"), so they survive JSON without losing precision. Parse them as big integers.

Errors

A request that cannot be served returns an error object with a stable code, a sentence written for a person, and whether trying again can help. A panel that could not be read is not an HTTP error: the route still answers 200 and that panel’s envelope carries the status.

{
  "error": {
    "code": "not-a-mint:wallet",
    "message": "This address is a wallet, not a token mint. You can open it as a wallet instead.",
    "retryable": false
  }
}
HTTP status codes
StatusWhen
400The address, signature or parameter is malformed. Nothing was looked up.
404No account exists at the address, or the transaction is outside the endpoint’s retention.
422The address exists but is not a token mint (a wallet, a token account, a program). The code says which.
429Too many requests from this address. A Retry-After header says how long to wait.
501The configured RPC endpoint does not serve the method this section needs.
502, 503, 504The RPC endpoint or a provider failed, rate limited or timed out. Retryable.

Rate limits

Limits are per client address in a fixed one-minute window. They are a courtesy bound on this server; the upstream providers’ own limits are the real constraint, which is why answers are cached and identical requests share one upstream call.

Rate limits
Kind of routePer minute
Reads (token, wallet, feed, explore)120
Search40
Scans (launch, exits, wallet activity)6

Token routes

GET/api/token/{mint}

Decimals, raw supply, mint and freeze authority, token program, interpreted Token-2022 extensions and metadata, read at one slot. Answers 422 with a reason when the address is not a mint.

fresh=1
Skip the server’s short cache of the mint account.

Returns { mint, state, index }: the mint account as read from the chain, and the token index record, each in its own envelope.

GET/api/token/{mint}/market

Pools from one market provider at a time. The headline price is the price in the pool with the largest reserve.

Returns An envelope around pools, the selected pool, price, liquidity, volume and market cap.

GET/api/token/{mint}/chart

Price candles of the selected pool.

range
24h, 7d (default), 30d or 90d.

Returns An envelope around the selected pool and its candles (time, open, high, low, close, volume in USD).

GET/api/token/{mint}/holders

A census of owners when the endpoint allows it, the largest token accounts when it does not, or an unavailable status. Never an estimate.

fresh=1
Skip the cache.

Returns { mint, holders, indexed }: owners read from the chain (census or largest accounts), and the provider’s indexed figures, each in its own envelope.

GET/api/token/{mint}/flows

Observed trading flow. Transfers and failed transactions are not counted; multi-hop and split routes are counted once.

Returns { sample, aggregate }: decoded swaps merged into economic trades with gross buy, gross sell, net, buckets and the newest trades; and the provider’s 24-hour totals.

GET/api/token/{mint}/signals

Every evidence rule evaluated for one token.

Returns An envelope around the findings for this token and the state of history storage.

GET/api/token/{mint}/history

The snapshots Dotstronic stored for the token, which the snapshot rules compare.

Returns An envelope around the stored snapshots, newest first (chain reading and provider figures at each time). Unavailable when history storage is not configured.

GET/api/token/{mint}/network

A bounded network of recent activity: who traded in which pool, and who transferred the token to whom.

Returns An envelope around nodes, edges with their supporting signatures, and the decoded transactions.

POST/api/token/{mint}/balances

Current balance of the token for a set of wallets.

body
{ "wallets": ["…"] } with 1 to 20 addresses.

Returns { mint, slot, decimals, balances }: a raw balance per wallet, or null where it could not be read (never zero).

GET/api/tx/{signature}

One transaction decoded by Dotstronic itself, as evidence behind a row.

mint or wallet
Whose movements to decode. One of the two is required.

Returns { signature, source, method, fetchedAt, summary, rules }: signers, programs, each classified movement and the text of the rule that classified it.

Wallet routes

GET/api/wallet/{address}

What lives at an address and what it holds now. A mint, a program and a token account are recognised and reported as such.

Returns { address, profile, holdings }: the kind of address and its owner program; and its token balances, each in its own envelope.

GET/api/wallet/{address}/activity

The newest transactions that name the address, decoded within a per-request budget.

limit
1 to 50, default 20.
before
A signature to page back from.

Returns Listed signatures, decoded transactions (movements, SOL change, transfers with a named counterparty), undecoded signatures and limitations.

Feed and discovery

GET/api/signals

The evidence feed across the followed tokens.

Returns An envelope around findings (rule id and version, token, window, inputs, threshold, coverage, evidence, data time, generation time), per-rule counts and the state of history storage.

GET/api/explore

One of the token index’s ranked lists. A provider list, not the whole market.

list
toptraded (default), toporganicscore or toptrending.

Returns An envelope around up to 100 rows of the provider’s list.

GET/api/search

Token search as far as the provider’s index goes.

q
A mint address (exact match) or a name or symbol, 2 to 60 characters.

Returns An envelope around matching rows and whether the query was treated as an address or as text.

GET/api/health

Measured status of the RPC endpoint, each provider and history storage.

Returns { network, methodologyVersion, measuredAt, overall, integrations }: one line per integration with its state, detail and latency.

Streamed scans

Long reads answer as newline-delimited JSON (application/x-ndjson): one event per line, ending with a result or an error event. Closing the connection cancels a scan nobody else is following.

GET/api/token/{mint}/launch

The launch-activity scan: finds the first transactions, decodes a bounded window, reads the first buyers’ funding and applies the connection rules.

fresh=1
Discard a remembered result and scan again.

Returns Events: stage (with real counts), located, tx (each decoded transaction), then result (coverage, creation, buyers, funding, relations, patterns, transactions, evidence) or error.

POST/api/token/{mint}/exits

What a chosen group of wallets did with the token afterwards.

body
{ "wallets": ["…"] } with 1 to 20 addresses.

Returns Events: stage, then result (still held, acquired, sold in decoded swaps, transferred outside, moved within the group, burned, unknown, with coverage per wallet) or error.

Operator route

GET/api/cron/snapshot

One bounded snapshot run for history storage. Requires Authorization: Bearer CRON_SECRET; closed entirely when no secret is configured. It writes at most one snapshot per token per time bucket, so calling it twice is harmless.

Returns { status, tracked, examined, written, skippedExisting, findings, pruned, nextCursor, notes }.

Without DATABASE_URL it reports not-configured and stores nothing. Setup is in the repository’s README.

Planned

These are not available. They are listed so they are not mistaken for something that exists.

  • MCP server for agent clients
  • Telegram alert delivery
  • Background alerts after the page is closed
  • Full-history holder cost basis

Definitions, thresholds and limits are in the methodology.