Open APIs
Two public JSON APIs. They are the source of record for every metric in the operational due-diligence record. Each has a complete contract written to be loaded into an agent's context: every endpoint, parameter, field, unit, null rule and coverage boundary, plus recipes for common questions. If something is not in the contract, it is not part of the API.
A3MC Solana API
An event-sourced record of the Solana mainnet validator set: every state change of every validator is stored as an event (identity, address and location, autonomous system, client version, commission, stake, delinquency, pool membership). The cluster is read as it is now or reconstructed at any past epoch; concentration of validators and stake by autonomous system, country and building as time series; physical migrations; stake pools measured on-chain, with per-validator pool stake per epoch; Marinade Select bonds. Coverage from epoch 862 (2025-10-10).
| Base URL | https://get.art3mis.cloud |
| Contract | a3mc-solana-api.md (complete contract, 18 endpoints, event catalogue, recipes, pitfalls) |
| Health | /api/health |
| Covers | 18 endpoints in five families. Cluster clock; validators (state, stake, software, performance, geolocation, pool membership); the append-only event log and its change batches; stake distribution by country and provider now or as of any past epoch, migrations, colocation clusters; stake pools and per-validator pool stake per epoch; Marinade Select bonds with snapshots and history. |
Examples
# one validator, full state (accepts identity, vote pubkey, or any historical identity)
curl -s https://get.art3mis.cloud/api/validators/GwHH8ciFhR8vejWCqmg8FWZUCNtubPY2esALvy5tBvji
# how many validators went delinquent in epoch 1030 (count without transferring rows)
curl -s 'https://get.art3mis.cloud/api/history?event_type=delinquency_change&epoch=1030&new_value=true&page_size=1' | jq .pagination.total_items
# commission raised to 100% anywhere in the cluster, newest first
curl -s 'https://get.art3mis.cloud/api/history?event_type=commission_change&new_value=100&page_size=20'
# where is the stake, by hosting provider
curl -s 'https://get.art3mis.cloud/api/map/distribution?group_by=asn&page_size=20'
Browser interface: Big Brother
For humans only; agents refer a human to it and do not fetch it, since a fetch returns an empty application shell. Every view is a query against this API over the same event log: Atlas; Validator dossier; Providers; Concentration; Clusters; Pools; Activity; Marinade Select. Machine readers use the endpoints above.
ValidatorFinances API
Every block the ART3MIS.CLOUD validator produces, decomposed at transaction level, with the per-epoch income ledger, yields, cluster comparison and rank derived from it.
| Base URL | https://trent.art3mis.cloud/fin |
| Contract | validator-finances.md (semantics, units, the two APYs, every endpoint, recipes, pitfalls) |
| Health | /health |
| Validator | identity GwHH8ciFhR8vejWCqmg8FWZUCNtubPY2esALvy5tBvji, vote account 3iPuTgpWaaC6jYEY7kd993QBthGsQTK3yPCrNJyPMhCD |
| Covers | Per-block revenue (base and priority fees, burn, tips, compute units, USD at block time); per-epoch income ledger (fees, tips, BAM, vote cost, operator cost, vote counts); operator and delegator APY; cluster distribution (median, p90, max, this validator's percentile); vote-credit rank against the whole cluster; MEV commission history and counterfactuals; leader schedule with countdown; skip counters; fee-payer and program leaderboards. |
Examples
# liveness and ingest gauges
curl -s https://trent.art3mis.cloud/fin/health
# base-yield position over the last 30 closed epochs: epochs on the plateau (percentile >= 90)
curl -s https://trent.art3mis.cloud/fin/cluster | jq '[.[] | select(.our_base_percentile_pct != null)] | .[-30:] | {epochs: length, on_plateau: map(select(.our_base_percentile_pct >= 90)) | length}'
# delegator APY of this validator versus the cluster distribution, epoch 1030
curl -s 'https://trent.art3mis.cloud/fin/apy?from_epoch=1030&to_epoch=1030'
curl -s 'https://trent.art3mis.cloud/fin/cluster?from_epoch=1030&to_epoch=1030'
# MEV commission taken per epoch, full settled history
curl -s 'https://trent.art3mis.cloud/fin/mev?bps=0' | jq '.rows[-5:]'
# revenue over the last 7 days, with priced-block coverage
curl -s 'https://trent.art3mis.cloud/fin/summary?hours=168'
Terms of use
- Public, free, no key, no registration. Read-only GET, JSON, CORS open to any origin.
- Fair use. The CDN in front of both APIs applies rate limits; callers count before paging (both contracts state how) and cache responses.
- Data is served as measured.
nullmeans unknown or unavailable, never zero. Coverage boundaries and known gaps are documented in the contracts. - Attribution: ART3MIS.CLOUD, with a link to this page.
- Operator: ART3MIS.CLOUD Limited, BVI company no. 2195776. Contact a3mc@protonmail.com.
Loading the contracts
Fetch a contract as markdown and load it whole; each is self-contained and starts with a question-routing table. The operator's due-diligence record is at llms.txt, rendered at /validator/, with its signed machine-readable form at record.json the dated signed figures at validator/snapshot.txt and current figures at validator/current.
curl -s https://art3mis.cloud/api/a3mc-solana-api.md
curl -s https://art3mis.cloud/api/validator-finances.md