Halloween 2026 su AstroNova · mancano 9 giorni · 5 premiCaccia alle zucche: 0/5
Per sviluppatori

Costruisci bot Discord, mod e siti con i dati veri del server. Gratis, senza chiave, in JSON.

In due righe
  • Indirizzo di base: https://astronovamc.it/api/v1. Tutte le rotte sono GET e rispondono in JSON.
  • Ogni risposta ha stato e risultato; se qualcosa non va, errore con la spiegazione in italiano.
  • Niente chiave e niente registrazione. Il limite è di 120 richieste di fila, poi 2 al secondo per indirizzo: oltre, la risposta è 429 e basta aspettare qualche secondo.
  • I dati si aggiornano dal vivo; le risposte si possono tenere in cache 30 secondi. Le chiamate dal browser sono permesse (CORS aperto).
const r = await fetch('https://astronovamc.it/api/v1/giocatori/ItzFedex_');
const { risultato } = await r.json();
console.log(risultato.nome, risultato.modalita.smp.blocchi_rotti);
Rotte

Stato del server

Se il server è acceso, quanti giocatori ci sono e chi, i TPS, l’indirizzo e le versioni con cui si entra.

GET /api/v1/server
Profilo di un giocatore

Il profilo pubblico: se è online, primo e ultimo accesso, tempo di gioco, rank, clan, voti e, per ogni modalità, uccisioni, morti, mob, blocchi e saldo. I giocatori Bedrock si trovano anche senza il punto davanti al nome.

GET /api/v1/giocatori/ItzFedex_
Classifiche

25 posizioni per pagina, fino alla pagina 20. Categorie: uccisioni, morti, mob, blocchi_rotti, blocchi_piazzati, tempo, ricchezza, venduto, speso, isole, livello_isola, voti. modalita è smp, oneblock o vanilla (non tutte le classifiche esistono ovunque: la risposta dice dove).

GET /api/v1/classifiche/blocchi_rotti?modalita=smp&pagina=1
Aste aperte

Le aste in corso, dalla più vicina alla chiusura: oggetto (col nome italiano), venditore, prezzo «compra subito», offerta attuale e scadenza.

GET /api/v1/aste?pagina=1
Aste vendute

Le ultime aste concluse con una vendita, con chi ha comprato e a quanto: la base per seguire i prezzi del mercato.

GET /api/v1/aste/vendute?pagina=1
Listino del negozio

Tutti gli oggetti dello /shop con prezzo d’acquisto, di vendita e di vendita netta (tolta la trattenuta). Filtri: cerca (nome italiano o id inglese) e categoria.

GET /api/v1/prezzi?cerca=diamante
Spawner

I 23 spawner del negozio: prezzo, drop, e la stima del gioco di Stelle ed esperienza all’ora, quando si riempie il magazzino e in quanto si ripagano.

GET /api/v1/spawner
Le regole

Tre cose
  • Scrivi da dove vengono i dati: «dati di AstroNovaMC» con un link a astronovamc.it.
  • Non fingerti il server o lo staff: il tuo bot è tuo, e deve dirlo.
  • Escono solo i dati che il sito mostra già a tutti. Se ti serve altro, o hai un’idea per una rotta nuova, chiedi su Discord.