QUINTRA
DocsDeveloper API

Every figure, as JSON.

Five public endpoints, all live, no key. They return the same data this site is built on, each with its source and the time it was read.

Base URL
https://usequintra.xyz
Amounts
Asset amounts are decimal strings in the smallest unit (wei for HYPE, 18 decimals for Montra coins), so nothing loses precision. Times are milliseconds since 1970.
Caching
Responses are cached at the edge with s-maxage and stale while revalidate, from 10 seconds for live state to an hour for a finished round.
Errors
JSON with an error message: 400 for bad input, 404 for a round that has not run, 503 when an upstream read fails. Never a made up zero.
01Live state

GET/api/state

Everything the home page shows: the phase, when the next round starts, the HYPE waiting for it, all time totals, the last round and the current five.

Returns StateResponseCache 10s at the edge, then 50s stale while revalidate
Parameters

None.

Request
curl https://usequintra.xyz/api/state
StateResponse fields
source
string
Where the data came from, for example "Montra API" or "Elysium · Quintra bot".
updatedAt
number
Milliseconds since 1970 when the data was read.
block
number | null
Elysium block the chain figures were read at, when they were.
stale
boolean?
True when the figure is older than its expected refresh period.
brand
object
name, ticker, tagline.
phase
"awaiting_launch" | "live"
awaiting_launch until the token address is set.
tokenAddress / botWallet
string | null
Null until posted.
botEnabled
boolean
False means dry run: rounds are computed and logged, nothing is sent.
chainId
number
Elysium, 99901.
roundMinutes
number
Round length.
nextRoundAt
number
Next round start, milliseconds since 1970.
budgetSoFar
string | null
HYPE waiting for the next round, in wei. Null before launch or when unreadable.
budgetSoFarUsd / hypeUsd
number | null
USD figures when a HYPE price is available.
totals
object
rounds, walletsPaid, airdroppedUsd (number | null), airdroppedHype (wei), burned (smallest unit).
lastRound
RoundSummary | null
The last finished round.
picks
RoundPick[]
The current five, short form.
picksUpdatedAt / lastScoreAt
number | null
When the last score run finished.
02Scores and the five

GET/api/picks

The latest score run: the five picks after the hold rule, the full ranking with every input, challengers waiting out the hold, and every left out coin with its reason. Answers 503 until the first score run has finished.

Returns PicksResponseCache 30s at the edge, then 120s stale while revalidate
Parameters

None.

Request
curl https://usequintra.xyz/api/picks
PicksResponse fields
source
string
Where the data came from, for example "Montra API" or "Elysium · Quintra bot".
updatedAt
number
Milliseconds since 1970 when the data was read.
block
number | null
Elysium block the chain figures were read at, when they were.
stale
boolean?
True when the figure is older than its expected refresh period.
runId
number | null
Id of the score run.
picks
ScoredCoin[]
The five, in rank order.
leaderboard
ScoredCoin[]
Every eligible coin, ranked.
challengers
Challenger[]
address, symbol, imageUrl, score, rank, heldMinutes, requiredMinutes, qualifiesAt.
excluded
ScoredCoin[]
Every left out coin with its reason.
exclusionCounts
Record<string, number>
Counts by exclusionKey.
topByMarketCap
object[]
Top five HYPE coins by raw market cap, for comparison.
universeSize
number
Coins checked in the run.
nextRunAt
number
Next scheduled score run.
ScoredCoin fields
address / symbol / name
string
The coin.
imageUrl
string | null
Coin image through /api/img.
poolId / quoteSymbol
string
Its Montra pool and the coin it is paired with.
priceUsd / change24hPct / marketCapUsd
number | null
Live market figures from Montra.
score
number | null
0 to 100; null when left out.
rank
number | null
1 based rank among eligible coins.
eligible
boolean
Whether it passed every filter.
exclusion / exclusionKey
string | null
Readable reason and machine key when left out, for example too_young, kntq_pair, low_liquidity, impostor.
inputs
ScoreInputs
volume24hUsd, marketCapUsd, twMarketCapUsd, volume1hUsd, traders1h, holders, liquidityUsd, ageHours, deepChecked.
parts
ScoreParts | null
volume and marketCap sub scores (0 to 100) and the weights applied.
minutesInTop
number
Minutes it has continuously held a top five rank.
launchedAt
number | null
Launch time, milliseconds since 1970.
03Rounds

GET/api/rounds?limit=

Summaries of live rounds, newest first. Dry runs are never listed here.

Returns RoundsResponseCache 30s at the edge, then 120s stale while revalidate
Parameters
Request
curl https://usequintra.xyz/api/rounds?limit=5
RoundsResponse fields
source
string
Where the data came from, for example "Montra API" or "Elysium · Quintra bot".
updatedAt
number
Milliseconds since 1970 when the data was read.
block
number | null
Elysium block the chain figures were read at, when they were.
stale
boolean?
True when the figure is older than its expected refresh period.
rounds
RoundSummary[]
Newest first.
total
number
Live rounds run so far.
RoundSummary fields
number
number
Round number.
dryRun
boolean
Always false on public routes.
status
string
scheduled, running, done, failed or skipped.
startedAt / finishedAt
number / number | null
Milliseconds since 1970.
budget
string
HYPE budget of the round, in wei.
budgetUsd
number | null
Budget in USD at the time, when known.
airdropHype / buybackHype / teamHype
string
The three shares of the split, in wei.
burned
string
Coins burned by the buyback, smallest unit.
walletsPaid
number
Wallets that received a transfer.
picks
RoundPick[]
address, symbol, imageUrl, score, rank of each of the five.
addsUp
boolean
True when every split and distribution sums back to the budget exactly.
04One round

GET/api/rounds/[number]

A round's full report: budget, split, picks, every buy and transfer with transaction hashes, rollover and the checks that prove it adds up. Answers 404 for a round that has not run.

Returns RoundReportCache an hour once done, 15s while running
Parameters
Request
curl https://usequintra.xyz/api/rounds/[number]
RoundReport fields
source
string
Where the data came from, for example "Montra API" or "Elysium · Quintra bot".
updatedAt
number
Milliseconds since 1970 when the data was read.
block
number | null
Elysium block the chain figures were read at, when they were.
stale
boolean?
True when the figure is older than its expected refresh period.
…RoundSummary
Every RoundSummary field.
holderToken / holderTokenSymbol
string / string | null
Token whose holders were paid.
fromBlock / toBlock
number | null
Block range the balances were weighted over.
claimed
object
hype (wei), txHash, claimable.
split
object
team, airdrop, buyback, basketPool, hypePool, compoundPool, perPick, dust (all wei).
choiceWeights
object
Total weight behind BASKET, HYPE and COMPOUND.
holders
number
Holders weighted.
buys
RoundBuy[]
kind, token, symbol, hypeIn, amountOut, chunks, scheduledAt, impactBps, status, txHashes, note.
transfers
RoundTransfer[]
wallet, asset, symbol, amount, status, txHash. Truncated to the largest.
transferCount
number
All transfers in the round.
rollover
object
wallets, owed: asset, symbol, amount.
burnMethod
string | null
burn() or dead address.
checks
object[]
name, ok, detail.
errors / log
string[]
Errors and the round's log lines.
05A wallet

GET/api/wallet/[address]

Everything one wallet has received, its value now, the loyalty multiplier, its payout choice, rollover owed and an estimate of its share of the next round. Answers 400 for an invalid address.

Returns WalletResponseCache 10s at the edge, then 30s stale while revalidate
Parameters
Request
curl https://usequintra.xyz/api/wallet/[address]
WalletResponse fields
source
string
Where the data came from, for example "Montra API" or "Elysium · Quintra bot".
updatedAt
number
Milliseconds since 1970 when the data was read.
block
number | null
Elysium block the chain figures were read at, when they were.
stale
boolean?
True when the figure is older than its expected refresh period.
address
string
Checksummed address.
phase
"awaiting_launch" | "live"
As in /api/state.
balance
string | null
Coin balance, smallest unit. Null before launch.
choice
"BASKET" | "HYPE" | "COMPOUND"
Payout choice. BASKET when never signed.
choiceSignedAt
number | null
When the choice was stored.
nextNonce
number
Nonce to sign the next choice with.
loyalty
object
multiplier, since (number | null), max, days.
received
WalletReceipt[]
round, asset, symbol, amount, txHash, at.
totals
object[]
asset, symbol, amount, valueUsd (number | null).
rollover
object[]
asset, symbol, amount owed.
estimate
object | null
shareBps, hype (wei), usd. Null when unknown.