ThesaurosDocs
Customer experience

Your Thesauros workspace

Sign in, read live protocol data and explore Earn with a persistent test account.

Open your account. Choose Individual or Institution and create an account with your name, email and a password of at least 12 characters. Institution accounts also include a company name.

Save the recovery key displayed after registration. Use Forgot password? with your email and that key to set a new password. Recovery signs out existing sessions. You can also change your password from Account while signed in.

Individual

  • Overview brings together your connected wallet, current Thesauros vault data and an external market comparison.
  • Connect wallet requests access to an Ethereum wallet already available in your browser. It reads the selected address's token and vault-share balances at a block on Base, Arbitrum, Plasma or Monad. The connection does not authorize a transfer.
  • Vaults & providers shows underlying assets, the reported supply APY, allocation and indexed lifetime activity where the monitoring source provides it.
  • Markets compares external lending markets and lets you inspect historical APY or liquidity observations.
  • Test account lets you request 10,000 test USDC, make a simulated deposit and withdraw. The account starts empty and its activity persists across sign-ins.

Institution

Institution includes the same protocol and market views, plus report exports, customer integration entry points and the developer tools previously accessed at /developers.

Developers contains Quickstart, API explorer, API keys, Webhooks, Usage, Reconciliation and Test customers. These tools use the shared API sandbox and retain the documented sandbox contracts. Sandbox customer records are separate from connected customer reporting in your Institution workspace.

The Customers page remains empty until a partner integration is connected. The workspace does not invent customer balances or attribute protocol-wide capital to your company.

Reading the numbers

View Source and units
Thesauros vaults Original Thesauros monitoring API. Underlying token amounts; APY in percent.
Vault lifetime activity Indexed events and totals, with the source's observation time and block range.
Market comparison DeFiLlama supply APY and market TVL in USD. External market liquidity is separate from Thesauros vault assets.
Wallet Read directly through the connected browser wallet's provider, at the displayed block.
Test account Persistent simulation. Fixed test rates and balances labeled test USDC.

Missing source values are shown as unavailable. An RPC failure does not become a zero APY. The interface preserves a last received source response when a refresh fails and shows its timestamp; it does not fabricate missing historical observations.

Build with us.

Bring your product flow. We'll map the integration together.

Discuss your integration
Continue readingAdd funds to Earn

Find an integration guide, API method or SDK example.

Thesauros documentationSearch runs in your browser