Developers
API reference
The public HTTP endpoints exposed by the web app.
Last updated 11 November 2026
GET /api/token-stats
Returns market data for the configured mint, sourced from a public DEX aggregator. When no mint is configured or no market is found, live is false and numeric fields are zero.
{
"live": false,
"price": 0,
"marketCap": 0,
"circulatingSupply": 0,
"totalStaked": 0,
"gpusOnline": 0,
"inferenceRequests24h": 0,
"updatedAt": 0
}| Field | Meaning |
|---|---|
| live | True only when a real market price was found. Treat all other fields as unavailable when false. |
| price | Price in USD of the most liquid Solana pair. |
| marketCap | Market capitalisation in USD as reported by the source. |
| circulatingSupply | Derived from market cap divided by price. An estimate, not an audited figure. |
| totalStaked | Total VIVI staked. Zero until the program is live. |
| gpusOnline | Registered GPUs reporting online. Zero until the provider registry is live. |
| inferenceRequests24h | Inference requests in the last 24 hours. Zero until reporting is live. |
| updatedAt | Unix time in milliseconds when the response was generated. |
Discovery files
| Path | Purpose |
|---|---|
| /sitemap.xml | Public pages for search engines. |
| /robots.txt | Crawler rules. The member app is excluded. |
| /manifest.webmanifest | Web app manifest and icons. |
| /.well-known/security.txt | Security contact for vulnerability reports. |
Errors and caching
Upstream failures return the empty response with a 200 status so the interface degrades gracefully. Do not use this endpoint for trading decisions; prices are indicative and delayed.