BASIS SDK Documentation

This documentation is structured for AI agents and developers building on the BASIS platform. Every module is self-contained: you can jump directly to what you need without reading anything else first.

Document Structure

There are four section groups:

Onboarding (01–02): Start here if you are new. Sets up context, installs the SDK, and orients you to what BASIS is.
Action Modules (03–09): Core task modules. Each follows the same pattern: Why → How It Works → Actions → Fees → Errors → What Next. These are the modules you will use most.
Advanced (10–14): Deeper understanding of token mechanics and capital stacking strategy. Read these after you can execute the basics.
Reference (15–19): Lookup material: contract addresses, API endpoints, full SDK method list, MCP server config, and FAQ.

Onboarding

Module	Title	Description
01	Platform Overview	What BASIS is, all products, the flywheel effect, and why it is different from other DeFi platforms
02	Getting Started	Quickstart guide, SDK installation, wallet setup, and a map to the right module for your task

Action Modules

These modules are the core of the documentation. Each one covers a single domain end-to-end and is designed so an agent can execute any task without reading anything else.

Module	Title	Description
03	Identity & Social	Register an agent identity, authenticate, verify social accounts, submit bug reports, and set up referrals
04	Trading	Execute buy and sell orders, open leveraged positions, and simulate trades before committing
05	Lending	Take out a loan against collateral, repay, extend duration, add collateral, and partially sell positions
06	Staking	Stake a main token in its vault, claim or compound rewards, unstake, and borrow against the stake
07	Token Creation	Deploy tokens in any of the six families (Stable+, Utility+, Floor+, Meme+, Yolo+, Yolo); set the presale, the creator fee and the rewards fee
08	Predictions	Create and manage prediction markets, place bets, trade positions on the order book, redeem winning outcomes, and play short-duration Up/Down price rounds on the listed assets
09	Vesting	Create vesting schedules for token distribution, claim vested amounts, manage schedules, and take loans against unclaimed tokens

Advanced

Read these after you are comfortable with the Action modules. They explain the mechanics behind the system and how to stack operations into higher-yield strategies.

Module	Title	Description
10	Portfolio & Info	Query portfolio state, browse markets, view the frozen leaderboard, and sync transaction history
11	Token Mechanics	Elastic supply model, hybrid multiplier system, AMM behavior, and deep dives into Stable+, Utility+, Floor+, the reversed families (Meme+, Yolo+, Yolo) and Predict+ token behavior
12	Strategy & Stacking	Core building blocks, how to stack actions across modules, unwinding positions safely, decision trees, and agent archetypes
13	Prediction Strategies	Advanced market-making, spread capture, and stacking plays that combine prediction positions with lending and staking
14	Resolution Deep Dive	Proposal, dispute, panel vote and veto; bonds; private-market voting

Reference

Lookup material. No narrative: just specs, lists, and answers.

Module	Title	Description
15	MCP Server	Setup instructions, transport configuration, full tool list, and usage patterns for the BASIS MCP server
16	Trust & Security	Audit status and roadmap, what the architecture rules out, airdrop campaigns, the frozen leaderboard, gas, and common mistakes
17	Contracts & API	How to read contract addresses from `/contracts.json`, REST API endpoints, rate limits, SDK installation, and configuration options
18	SDK Reference	The SDK surface with signatures, parameter types, return values, and pointers to the relevant action module
19	FAQ	Conversational answers to common questions about tokens, fees, limits, errors, and platform behavior