Skip to main content
Record that one or more allocations were claimed off-chain — for example through a centralized exchange — rather than on-chain through Magna. Ownership of the wallet is proven with a signed message. Route: POST /api/external/v1/allocations/off-chain-claim

​
Headers

HeaderRequiredDescription
Content-TypeYesMust be application/json
x-magna-api-tokenYesYour Magna API token

​
Body parameters

FieldTypeRequiredDescription
tokenIdstring (uuid)YesThe token whose allocations are being claimed
walletAddressstringYesThe claiming wallet address
messagestringYesBase64-encoded JSON message that was signed (see below)
signaturestringYesSignature of message produced by walletAddress
The decoded message is a JSON object:
FieldTypeDescription
cexIdstringIdentifier of the exchange / custodian processing the claim
externalWalletAddressstringThe wallet address on the external platform
externalUserIdstringThe user identifier on the external platform
distributionIdsstring[]Distribution IDs being claimed off-chain

​
Request example

curl -X POST https://app.magna.so/api/external/v1/allocations/off-chain-claim \
-H 'Content-Type: application/json' \
-H 'x-magna-api-token: YOUR_API_KEY' \
-d '{
  "tokenId": "b3f1c0d2-1111-2222-3333-444455556666",
  "walletAddress": "0xAbC...123",
  "message": "<base64-encoded-json>",
  "signature": "0x<signature>"
}'

​
Response example

{
  "processed": true
}