How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Totalis User API

User profile, wallet, and devnet helpers.

Totalis User API is one of 7 APIs that Totalis publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include User. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 10 operations across 10 paths, and defines 12 schemas. It is described by OpenAPI 3.2.0, at version 2.1.0.

Requests are made against a single base URL, https://api.totalis.trade.

10 operations 10 paths 12 schemas 6 GET3 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2.1.0
Base URL
https://api.totalis.trade
Authentication
HTTP Bearer, API Key
Resource Areas
1

Authentication & Security 2

Totalis User API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (JWT) (PrivyJWT). An API key is passed in the header as X-API-Key (ApiKey). By default, every request must be authenticated.

  • PrivyJWT — Privy JWT issued to the web dashboard. Sent as Authorization: Bearer . The Privy session signer underpins all wallet-signed actions.
  • ApiKey — Programmatic API key. Sent as X-API-Key: . Generate one from the Totalis dashboard. The same header is accepted on the WebSocket auth message.

Paths & Operations 10

Across 10 paths, the API surfaces 10 operations — 6 GET, 3 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

User 10

User profile, wallet, and devnet helpers.

GET
/v1/me
Get Profile
getOrCreateUser 1 param → 200401
PUT
/v1/username
Update Username
updateUsername body → 200400401409
GET
/v1/username/check
Check Username
checkUsername 1 param → 200401
GET
/v1/wallet
Get Wallet
getWallet → 200401
GET
/v1/wallet/blockhash
Get Blockhash
getBlockhash → 200401
POST
/v1/wallet/submit-tx
Submit Transaction
submitTransaction body → 200400401429
GET
/v1/portfolio
Consolidated portfolio (balance, stats, counts, summary)
getUserPortfolio → 200
GET
/v1/wallet/delegation-status
Check TEE wallet delegation status
getDelegationStatus → 200
POST
/v1/wallet/enable-trading
Confirm TEE wallet delegation AND drain any pending welcome airdrop
enableTrading → 200401
POST
/v1/wallet/withdraw
Withdraw USDC from the embedded wallet to an external address
withdrawFromWallet 1 param body → 200400401409429500502

Schemas 12

The contract defines 12 schemas that model the data the API accepts and returns. The most detailed are RfqCounts (9 properties), User (9 properties), UserStats (6 properties), Wallet (6 properties). Each schema is shown below with its type and property counts.

PortfolioSummary
object
Derived portfolio-level aggregates from active positions.
3 properties
AirdropDrainOutcome
object
Outcome of the pending-airdrop drain performed by POST /v1/wallet/enable-trading. Narrower than AirdropOutcome — there is no pending field because the drain is…
2 properties 2 required
UserStats
object
6 properties
PortfolioData
object
Consolidated portfolio response from GET /v1/portfolio.
4 properties
User
object
9 properties
PortfolioBalance
object
Caller's vault balance (DB-cached, no RPC). Null only when the caller has no vault row at all. For dual-role accounts the bettor-side vault is preferred and th…
5 properties
Wallet
object
6 properties
ErrorBody
object
4 properties 2 required
DelegationStatus
object
4 properties
AirdropOutcome
object
Welcome airdrop outcome. success: true with pending: true means the amount was staged and will mint on the user's next POST /v1/wallet/enable-trading call. suc…
3 properties 3 required
ErrorEnvelope
object
1 property 1 required
RfqCounts
object
9 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

totalis-user-api-openapi.yml Raw ↑

Other APIs Totalis publishes across the network.

Totalis API Keys API
Totalis Markets API
Totalis Portfolio API
Totalis RFQs API
Totalis Vault API
Totalis Webhooks API
Where this information came from

This is an independent, third-party profile of Totalis User API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.