Developer Docs

Authentication

All endpoints require the following headers unless otherwise noted:

string

required

Bearer token (JWT) for end-user authentication. Format: Bearer YOUR_JWT_TOKEN

string

required

Your Magic secret key for application-level authentication.

Sign Data

Sign data with the authenticated user’s Magic wallet.

cURL

curl -X POST 'https://uoa-server.magic.xyz/wallet/sign' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer USER_JWT_TOKEN' \
  -H 'X-MAGIC-SECRET-KEY: YOUR_MAGIC_SECRET_KEY' \
  -d '{
    "message": "Hello, world!"
  }'

Response:

{
  "success": true,
  "signature": "0xabcdef1234567890...",
  "raw_data_hash": "0x1234567890abcdef...",
  "app_user_id": "user-123"
}

Request Parameters

string

A 0x-prefixed hex hash to sign directly. Provide either this or message.

string

A plain text message to hash (keccak256) and sign. Provide either this or raw_data_hash.

You must provide raw_data_hash or message. If both are provided, raw_data_hash is signed.

Response Fields

boolean

Whether the signing operation completed successfully.

string

The hex-encoded signature.

string

The hash that was signed.

string

The user identifier from your application.

Withdraw to External Address

Send funds from the authenticated user’s Magic wallet to an external address.

cURL

curl -X POST 'https://uoa-server.magic.xyz/withdraw' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer USER_JWT_TOKEN' \
  -H 'X-MAGIC-SECRET-KEY: YOUR_MAGIC_SECRET_KEY' \
  -d '{
    "to_address": "0xRecipientAddress...",
    "amount": "50",
    "token": "USDC",
    "chain": "ARB"
  }'

Response: message is generated by the server (success text includes amount, token, and chain, and notes EIP-7702 gas-sponsored sends when applicable). tx_hash is an EVM transaction hash (0x…) or a Solana signature string depending on chain.

{
  "success": true,
  "tx_hash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
  "from_address": "0x1234567890abcdef1234567890abcdef12345678",
  "to_address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "amount": "50",
  "token": "USDC",
  "chain": "ARB",
  "message": "Successfully sent 50 USDC on ARB"
}

Request Parameters

string

required

The recipient wallet address. EVM destinations are normalized to checksummed hex; Solana addresses are validated as base58.

string

required

The amount to withdraw as a decimal string.

string

default:"USDC"

The token to withdraw. Values: ETH, USDC, USDC.E, POL, SOL

string

default:"ARB"

The chain to withdraw on. Values: ETH, ARB, POL, SOL, INK

boolean

default:"false"

Request gas-sponsored execution for EVM withdrawals when supported (Alchemy EIP-7702 path). Ignored for Solana (should_sponsor_gas is false on SOL).

Supported Token/Chain Combinations

Chain	Supported Tokens
ETH	ETH, USDC
ARB	ETH, USDC, USDC.E
POL	POL, USDC, USDC.E
SOL	SOL, USDC
INK	ETH, USDC

Response Fields

boolean

Whether the withdrawal was executed successfully.

string

The on-chain transaction identifier (EVM: 0x tx hash; Solana: base58 signature).

string

The sender’s wallet address.

string

The recipient’s wallet address after server-side normalization.

string

The amount withdrawn.

string

The token that was withdrawn.

string

The chain the withdrawal was executed on.

string

Human-readable status message describing the completed withdrawal.

Unified Orchestration Accounts

API Reference

Wallet Operations

Authentication

Sign Data

Request Parameters

Response Fields

Withdraw to External Address

Request Parameters

Supported Token/Chain Combinations

Response Fields

​Authentication

​Sign Data

​Request Parameters

​Response Fields

​Withdraw to External Address

​Request Parameters

​Supported Token/Chain Combinations

​Response Fields

Authentication

Sign Data

Request Parameters

Response Fields

Withdraw to External Address

Request Parameters

Supported Token/Chain Combinations

Response Fields