Introduction - Magna Docs

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 wrap the resource in an isProcessed / result envelope:

{
  "isProcessed": true,
  "result": {
    "...": "the requested resource"
  }
}

Errors use the same envelope shape with isProcessed: false and an error object instead of result:

{
  "isProcessed": false,
  "error": {
    "type": "ForbiddenError",
    "message": "Invalid API key for project"
  }
}

The token supply endpoints (total, unlocked, and locked supply) are the exception — they return a raw plain-text number rather than the JSON envelope, for CoinMarketCap compatibility.

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.

APIs Overview Authentication

​Base URL

​Response envelope

​What you can do

Allocations

Transactions

Tokens

Statistics

Base URL

Response envelope

What you can do