Build on MAGMA
MAGMA is a yield-bearing narrative capital market on Solana. Participants back narratives with capital; principal is routed into DeFi yield while a Conviction Score and on-chain oracle determine how that yield is multiplied or redistributed. These pages are the technical reference for everything you need to build against the protocol — the REST API, the TypeScript SDK, the x402 machine-payable endpoints, and the protocol internals underneath.
This is the developer & integrator portal — API contracts, SDK references, oracle/pool mechanics, and partner-grade material (MAGMA Shield, DeFi yield routing, MWA flows). For consumer onboarding and product walkthroughs, see docs.magmaprotocol.xyz.
Start here
Getting Started →
Base URLs, authentication, your first API call and first SDK call in under five minutes.
API Reference →
The full REST surface: narratives, conviction, DeFi, borrow, verify, NFT, shield.
TypeScript SDK →
Typed client for every resource, with helpers for wallet auth and pagination.
x402 Payments →
Pay-per-call, machine-payable endpoints using the x402 settlement standard.
Protocol Internals →
YBNCM model, Conviction Score, the oracle stack, pool architecture and multichain.
Advanced →
MAGMA Shield, borrowing, DeFi integrations, yield routing, and MWA transaction flow.
The shape of an integration
A typical integration reads narratives and conviction data, submits backings (signed by the user's wallet), and tracks positions and yield. Everything the API exposes is also available through the SDK with full TypeScript types.
Conventions used throughout
| Convention | Meaning |
|---|---|
https://api.magmaprotocol.xyz | Production REST base URL (devnet beta) |
| GET POST | HTTP method for an endpoint |
| AUTH | Endpoint requires wallet/admin authentication |
:wallet, :id | Path parameters you substitute |
MAGMA is experimental software running on Solana devnet. Contracts, economic parameters, and endpoints may change. Do not commit capital you cannot afford to lose entirely. See Legal & Compliance and Security.