Skip to main content
The Admin API (also called the Magna External API) lets you integrate Magna features outside of the Magna platform. With it you can retrieve allocation lists for a project, fund those allocations, trigger claims and withdrawals, index transactions, and read token supply data — all from your own backend. It is a private API: every request is authenticated with a project API key that you generate in the Magna admin dashboard. It is intended for server-to-server automation and back-office workflows, not high-frequency public traffic. For the public, browser-facing API behind claim portals, see the Portal API. Magna issues two kinds of key — a Full Access API Token for everything and a read-only Statistics API Key for the supply endpoints. See Authentication → API key types.

​
Base URL

https://app.magna.so/api/external/v1

​
Response envelope

Successful responses return the requested resource as JSON. Errors return a consistent envelope: 
{
  "isProcessed": false,
  "error": {
    "type": "ForbiddenError",
    "message": "Invalid API key for project"
  }
}
Every request must include your API key in the x-magna-api-token header. See Authentication to generate a key and learn about scopes.

​
What you can do

Allocations

List, create, modify, claim, and release allocations.

Transactions

Build signing parameters and index transactions.

Tokens

Read token summaries and supply figures.

Statistics

Read total, unlocked, and locked token supply.