Skip to main content
The Portal API is the public, browser-facing API behind Magna claim portals. It serves the data a stakeholder needs to view and claim their allocation directly from a portal frontend — without any project API key.

​
Base URL

https://portal-api.magna.so

​
Versions

The Portal API ships in two versions that run side by side.

v1 — fully public

No authentication. Read-only portal data (allocations, claim parameters, portal configuration) intended to be safe for public consumption.

v2 — wallet authenticated

Adds wallet authentication: the caller proves wallet ownership via a signed nonce (sign-in) before accessing wallet-scoped data and actions.
v1v2
AuthNone (fully public)Wallet signature (sign-in with a signed nonce)
ScopePublic, read-only portal dataWallet-scoped data and actions
When to useRendering public portal contentAnything tied to a specific authenticated wallet
The endpoint pages in the API Reference section are generated from the Portal API’s live OpenAPI spec, so paths, parameters, and response schemas for both versions stay in sync with the running service automatically.

​
How it differs from the Admin API

The Portal API is public and powers end-user portals. To manage allocations, funding, and other back-office operations from your own systems, use the private, API-key-authenticated Admin API instead. See the APIs overview for a side-by-side comparison.