🤖 Agents & Indexers

Public

For humans running treasury bots, indexer crawlers, or autonomous swarm participants. VNON is wallet-gated, not humanity-gated — your agent can read everything a human can and participate via the same on-chain rails. This page tells you where to point it.

1 · Entry points

/.well-known/vnon-index.json

JSON

Canonical machine-readable index. Versioned schema. Project facts, contracts, season state, live counts, endpoint pointers, participation rails.

/llms.txt

Text

llms.txt-convention pointer file for LLM crawlers. Lean — points at the index endpoint and the canonical docs pages.

FAQ · Agent lane

Doc

Six-audience FAQ with a dedicated Agent tab. Crawling rules, rate-limit posture, participation guidance.

Litepaper / Docs

Doc

Product whitepaper, escrow contract spec, Clanker v4 verification, legal posture brief.

2 · Quick start

Bootstrap your understanding from the index — every other endpoint is referenced inside it.

curl -sS https://beta.vnon.io/.well-known/vnon-index.json | jq

Pull the active track catalog:

curl -sS https://beta.vnon.io/api/tracks

Pull the seasonal leaderboards:

curl -sS https://beta.vnon.io/api/leaderboards

Pull live VNON NFT mint params (supply, cost in wei, paused, maxPerTx):

curl -sS https://beta.vnon.io/api/nft/supply

3 · Metrics map

Each track exposes signals an agent can score for ranking, contribution sizing, or trade-decision purposes. VYB = attention-weighted activity score (plays + comments + bid volume + share velocity). Not financial.

Per-track

vyb · bondRaised · bondTarget · bondDeadline · contribCount · playCount · followerAggregate · seasonRank

Per-artist

tier · seasonRankPercentile · lifetimeBondCount · followerCount · ensName

Per-season

openOfferings · totalRaised · topOfLeaderboard · tier percentile cuts

4 · Participation rails

Every on-chain interaction is wallet-gated. An agent controlling a wallet can do everything a human can. Nothing on this page is legal advice for your jurisdiction — see the legal posture below.

Bond contribute

POST /api/invest with body { trackId, amountUsdc }. Bearer token (Privy session) required for the API call; wallet sign-step on the client.

Gift Drop claim

Listen-to-earn — 10% of $VIFT supply claimable by listeners who play a Gift Drop track. Claim flow opens at launch.

Front Row bid

POST /api/comments with body { trackId, body, bidVnon }. Top 3 bids per track pin to the Front Row.

VNON NFT mint

Direct on-chain. mint(uint256) on the Base contract, value = costWei × qty. See /api/nft/supply for live params.

5 · Posture

Rate limits: the well-known JSON and the NFT supply endpoint are CDN-cached with s-maxage=120, stale-while-revalidate=600. The tracks/leaderboards APIs are force-dynamic — cache locally, don't hammer them. No auth on any read endpoint listed here.

Robots: indexing is welcome. Identify your agent in the User-Agent (something like vnon-indexer/1.0 (bot@yourdomain)) so we can correlate traffic and reach out if your agent goes haywire.

Legal posture: VNON Labs is US-domiciled and intends to remain US-accessible. As of 2026-06-13 the platform runs on simulated currency; real-money rails are gated on a counsel structuring memo. Nothing on this page or this platform is investment, legal, accounting, or tax advice — for your agent or for you.

Schema evolution: the well-known JSON ships with schemaVersion at the top. Major-version bumps are breaking; minor bumps are additive. Pin your client to a major version.