Documentation

How NIMBRA works

Hold $NIMB on Elysium, sign in with your wallet, and use the AI models your tier opens — in the chat or through an OpenAI-compatible API.

Quick startAPIErrorsllms.txt

Getting started

  1. Install a wallet. Rabby or MetaMask. NIMBRA adds the Elysium network (chain 99901) for you.
  2. Connect and sign one message. Signing in is free: no transaction, no gas, nothing is approved or moved.
  3. Use your tier. It is set by the $NIMB you hold. Without a wallet you still get a few free messages a day on a free model.

Access & tiers

Each tier unlocks a set of models and a daily allowance in US dollars — the real provider price of what you use. The allowance resets at 00:00 UTC.

TierHoldModelsDaily allowanceAPI

Holding rule

Access counts the lowest balance your wallet had during the last 24 hours. Tokens bought or received a minute ago start counting once they have been held for the whole window. This stops the same tokens from being passed between wallets to unlock access many times.

24 h ago now counted
Wallet balanceWhat counts for your tier: the lowest point

Chat

  1. Pick any model your tier allows. Models are grouped by lab; ones above your tier stay in the list, locked, with the tier that opens them. Answers stream as they are written, and the price per million tokens sits next to the picker.
  2. Conversations stay in your browser. Clear them any time from the sidebar.
  3. Watch your allowance. The card in the sidebar shows today's spend; the full history is in your account.

API

Pro and Whale holders create API keys on the Token page. The API is OpenAI-compatible: point any OpenAI SDK at the base URL and keep your code. API spending shares the daily allowance with the chat.


        

        
Endpoints

        

          
POST/api/v1/chat/completionsChat completions, stream: true supported.

          
GET/api/v1/modelsModels with prices; allowed marks the ones open to your tier.

          
GET/api/v1/usageYour tier, today's spend and recent requests.

        

        
Keys can be revoked any time. A new key is shown only once, so store it safely.

      


      

        
Errors

        
Errors come back as {"error": {"code", "message"}} with the HTTP status below.

        

          
401 unauthorizedNo valid session or key.

          
402 quota_exceededToday's allowance is used up. Free models keep working.

          
402 trial_exhaustedFree trial messages used up for today (per device and per network).

          
403 model_not_allowedThe model is above your tier.

          
403 tier_has_no_apiAPI keys need Pro or higher.

          
413 too_largeRequest body over the size limit.

          
429 rate_limitedToo many requests in a minute. Slow down.

          
429 too_many_concurrentToo many requests in flight at once.

          
503 paused / global_limitService paused, or today's capacity is reached.

        

      


      

        
Privacy

        

          We relay your request to the model provider and record only the model, token counts and cost against your wallet. Prompts and answers are not stored on our servers. Your wallet address is public, like any on-chain activity.

        
For AI agents, a machine-readable summary lives at /llms.txt.

      


      

        
FAQ

        

          
Do I need an account?
No. Your wallet is the account; its signature signs you in.

          
Does signing in move my tokens?
No. NIMBRA only reads your balance. Nothing is locked or transferred.

          
When does my tier update?
Balances are checked every few minutes; the holding rule decides when new tokens start counting.

          
What happens when my allowance runs out?
Paid models pause until 00:00 UTC. Free models keep working.