Back to the docs

Partner API: coin attention

For platforms that show Voxight data to their own users. Your users never pay Voxight: you hold a prepaid USDC balance and Voxight deducts per reading.

Call

GET https://www.voxight.online/api/coin-attention?mint=<token address>&symbol=<TICKER>
Authorization: Bearer <your partner key>

GET https://www.voxight.online/api/coin-attention/deep?mint=<token address>&symbol=<TICKER>
Authorization: Bearer <your partner key>

mint (a Solana mint or a 0x token address) or symbol is required; both is best. POST with a JSON body {"mint": "...", "symbol": "..."} works the same. X-Voxight-Key: <key> is accepted instead of the Authorization header.

Answer

  • data.windows: 9 windows (5m, 15m, 30m, 1h, 4h, 12h, 24h, 3d, 7d), each with mentions, previous (the window of the same length just before), change_pct, per_hour and trend (accelerating, building, steady, cooling, quiet, new).
  • data.last_hour_voices: distinct accounts, repeated lines, the busiest account's share, shill_suspected with reasons.
  • Deep reading only, data.insights: sentiment, KOL presence and coordinated promotion suspected, FUD, the project's X account, website and Telegram, organic share, conversation age and momentum (see the docs).
  • data.sources: today X. data.disclaimer: attention, never price.
  • partner: reading (free, balance or shared), charged_usdc, balance_usdc, free_readings_left.

Show it as attention data, never as a price signal or trading advice.

Billing

  • 0.15 USDC per fresh reading, 0.30 USDC per fresh deep reading (the CFO sets these; your key's answers show what was charged).
  • The same coin asked again by you within 60 seconds is free, so many of your users looking at one coin cost one reading.
  • A pilot allowance of free readings is agreed with each partner.
  • Top up by sending USDC to Voxight's receiving address on Solana or Base (given to you privately, never from a chat message alone), then send us the transaction hash: the balance is credited once the transfer is checked on chain.
  • At zero balance the call answers 402 "partner balance too low": nothing is served unpaid and nothing breaks.
  • Balance and the last 24 hours: GET https://www.voxight.online/api/partner/usage with the same key.

Limits and keys

  • 120 calls a minute per key.
  • Errors: 400 bad coin, 401 unknown key, 402 balance too low, 429 rate, 503 X could not be read (not charged).
  • Keep the key on your server, never in a browser or an app bundle. Ask for a new key at any time; the old one is switched off. Voxight keeps only a hash of it.

Contact

Partners talk to Voxight through Kognai: kognai.ai.