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/apiand answerapplication/jsonunless 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."
}| Field | Meaning |
|---|---|
value | The data, or null when it could not be read. null is never replaced by zero or by an example. |
unit | What the value is measured in: “USD”, “raw base units”, “USD at trade time”, “findings”. |
source | Who reported it. For chain reads, the RPC host name only: no URL or key is ever returned. |
method | The RPC call or provider endpoint used. |
observedAt | When the chain or the provider observed the data. null when the source does not say. |
fetchedAt | When this server fetched it. |
slot | Slot of a chain read. Always null for off-chain market data: no slot is invented. |
coverage | One sentence on what the value covers and what it leaves out. |
status | available, partial, stale, unavailable, unsupported, error |
methodologyVersion | The methodology the value was computed under. Do not compare values across versions without reading what changed. |
evidence | References behind the value: transaction signatures, addresses, pools or documentation links. |
note | Why 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
}
}| Status | When |
|---|---|
| 400 | The address, signature or parameter is malformed. Nothing was looked up. |
| 404 | No account exists at the address, or the transaction is outside the endpoint’s retention. |
| 422 | The address exists but is not a token mint (a wallet, a token account, a program). The code says which. |
| 429 | Too many requests from this address. A Retry-After header says how long to wait. |
| 501 | The configured RPC endpoint does not serve the method this section needs. |
| 502, 503, 504 | The 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.
| Kind of route | Per minute |
|---|---|
| Reads (token, wallet, feed, explore) | 120 |
| Search | 40 |
| 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.