GET https://api.soliscope.io/v1/reputation/:wallet
X-API-Key: sk_your_key
Accepts a deployer or funder address (base58) — pass whatever wallet you have; the funder chain is resolved internally as context. Responses come from the reputation database only (no on-chain calls in the request path), typically well under 100ms.
Response — verdict layer (all tiers)
Field
Type
Description
wallet
string
The address you queried.
verdict
enum
block | caution | no_flags | unknown — Soliscope’s default skip policy applied to the signals. Policy, not prediction: no_flags claims detection coverage, never safety.
confidence
enum
high | medium | low — scales with the deployer’s resolved-launch sample size.
reasons
enum[]
Machine-readable codes backing the verdict (full enum below). Stable; additions are non-breaking.
dataAsOf
ISO 8601
Freshness of the underlying reputation data.
Response — evidence layer (Builder and above)
Field
Type
Description
role
enum
deployer | buyer | funder | unknown — the primary role Soliscope knows this wallet by. A single wallet can hold multiple roles simultaneously; each populated role appears in its own field below.
deployer
object | null
launches, rugs, resolved, graduated, rugRate. Derived live from tracked launch rows; resolved counts launches with a known outcome.
deployer.rugRate
number | null
rugs ÷ resolved. Null when nothing has resolved yet.
buyer
object | null
appearances, wins, rugs, winRate, tier — the wallet's proven-winner track record as an early buyer of graduating tokens. Present when the wallet has ≥1 win. Tier: elite (≥3 wins) / proven (≥2) / rising (≥1) — measured graduation lift ~4.0× / ~3.5× / ~2.6× baseline. See /methodology.
funder
object | null
address, deployersSeeded, deployersRugged — the wallet that funded this deployer and its distinct-deployer track record. Provenance context, not scored: a de-confounded audit (see /methodology) found the funder-chain signal was not predictive, so it is exposed as data but never feeds the verdict or confidence.
Reason codes
Field
Type
Description
deployer_serial_rugger
block
2 or more confirmed rugs by this deployer.
deployer_rug_rate_extreme
block
Rug rate ≥ 50% over at least 4 resolved launches.
deployer_prior_rug
caution
Exactly 1 confirmed rug.
token_risk_flags
caution
Launch-level signals (bundle, concentration) are high — launch-risk endpoint only. Never escalates to block on its own.
deployer_clean_history
no_flags
3+ resolved launches, zero rugs. Coverage claim, not a safety claim.
insufficient_history
unknown
Not enough resolved history to say anything. Fresh wallets are unknown, not safe.
Errors
Field
Type
Description
400
status
Invalid Solana address.
401
status
Missing or invalid X-API-Key.
403
status
Key revoked.
429
status
Rate limit (per-second) or monthly quota exceeded — the error message says which. Respect Retry-After.
Need more than 30 requests/minute, or reputation signals pushed at launch time? Higher-limit tiers, webhooks, and the launch-time reputation stream are in development — email hello@soliscope.io and tell us what you're building.