---
name: laevitas-agents
description: Discover crypto market data, connect a wallet, inspect credits and purchase agent access.
---
# Laevitas agents

Install the official CLI from https://cli.laevitas.ch. Install its agent instructions with npx skills add laevitas/cli.

    laevitas agent catalog
    laevitas agent sample
    laevitas wallet init --generate
    laevitas agent login
    laevitas agent claim
    laevitas agent balance
    laevitas agent usage

The catalog at https://apiv2.laevitas.ch/api/v1/agents/catalog is authoritative for availability and prices. The sample is fixed fictional data and is free.
Wallet sign-in proves ownership, authorizes no payment and creates no dashboard account. Signing stays in your wallet.
The native CLI supports Base EOA wallets. HTTP sign-in also supports Solana Ed25519; read the returned network and sign the exact message.
Never paste private keys, seed phrases, session tokens or API keys into chat. Keep credentials in the local environment or private config.

## Starter credits — verify your wallet, then claim

Claim 1,000 free credits once per wallet while the launch offer is available.
Run laevitas agent claim after wallet sign-in. Eligibility requires at least 3 outgoing transactions confirmed at least 7 days ago on Base or Solana mainnet, or a completed agent purchase of at least $1.00. Empty new wallets do not qualify for free live credits; the public sandbox remains available.
Read starterOffer.eligibility and starterOffer.limits for current terms. Claims are limited per IP (IPv6 /64) and globally each UTC day. The same wallet receives only one grant, even with a new session or another network. Duplicate claims return HTTP 200 with alreadyClaimed:true and the original creditsGranted; they add zero further credits.
HTTP: POST https://apiv2.laevitas.ch/api/v1/agents/credits/claim with an empty JSON object and Authorization: Bearer SESSION_TOKEN from wallet verification.
Eligible established wallets need no payment, API key, card, email or dashboard account. POST requires a verified wallet session (401 otherwise), ineligible claims return 403, limits return 429, and unavailable eligibility checks return 503 without granting credits. Caller-provided wallet addresses and amounts are rejected.
Credits cover live REST and MCP, have no expiry, and do not grant Enterprise keys. Browser: https://app.laevitas.ch/claim.
Read https://apiv2.laevitas.ch/api/v1/agents/credits for your balance and https://apiv2.laevitas.ch/api/v1/agents/usage for claims and spending. When empty, choose a paid credit pack explicitly.

## Credits and purchases

    laevitas agent quote credits-100
    laevitas agent pay CHECKOUT_ID --max-usdc 0.10
    laevitas agent status CHECKOUT_ID
    laevitas agent balance
    laevitas perps carry BTC-PERPETUAL -p 1h -n 1 -o json

A quote spends nothing. Only an explicit pay command signs a payment, bounded by --max-usdc. After interruption, poll status before paying again.
Claimed and purchased credits use the same balance. Credit tokens authorize metered REST and MCP calls. Account reads and synthetic samples spend no credits.
WebSocket passes and tick-data exports have separate prices; do not assume a REST credit pays for every service.

## Agent Enterprise

    laevitas agent quote agent-enterprise --cycle MONTHLY
    laevitas agent pay CHECKOUT_ID --max-usdc YOUR_APPROVED_LIMIT
    laevitas agent keys create --label research

The price is 25% below the same current Enterprise billing period. Prepaid, no automatic renewal, no dashboard seats.
Only an active Agent Enterprise subscription can create or use API keys. Keys are returned once and can be revoked immediately.
Use the CLI and its terminal dashboards with either metered wallet access or your Enterprise key.

## HTTP

POST https://apiv2.laevitas.ch/api/v1/agents/auth/challenge with {"kind":"base","address":"YOUR_ADDRESS"}, or kind solana.
Verify audience, network, expiry and the full sign-in message before signing it.
POST https://apiv2.laevitas.ch/api/v1/agents/auth/verify with challengeId, challengeToken and signature (Base: 65-byte EIP-191 hex; Solana: 64-byte Ed25519 hex without 0x).
Use Authorization: Bearer SESSION_TOKEN for account, balance, usage, quotes and key management. Sessions last 15 minutes.
POST https://apiv2.laevitas.ch/api/v1/agents/quotes with productId, requestId (a UUID retained for retries), and cycle for a subscription.
Follow the returned paymentUrl with X-Checkout-Token. Handle the x402 PAYMENT-REQUIRED, PAYMENT-SIGNATURE and PAYMENT-RESPONSE headers.
Use the returned X-Credit-Token for data requests; renew it by signing in again. Consult https://apiv2.laevitas.ch/.well-known/x402 and /redoc for resource schemas.

## Agent clients and chat

Any agent with a shell can use the CLI's JSON output. Hermes can use the installed CLI skill; its Telegram connection uses the same local wallet.
Custom chat or Telegram bots should invoke fixed CLI argument arrays, allowlist users and instruments, and require a human-approved spending limit.
Do not interpolate chat text into a shell command. Client examples: https://github.com/Laevitas/cli/tree/main/examples/agents.
MCP clients can connect to https://apiv2.laevitas.ch/api/v1/mcp with an Enterprise X-API-Key or a current X-Credit-Token.
An MCP client must support x402 payment or use the CLI to buy credits first. A plain chat UI does not become a paying wallet automatically.
