Create Transfer

curl -X POST /api/v1/transfers \
  -H "x-api-key: mh_live_abc123..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "tokenMint": "So11111111111111111111111111111111111111112",
    "amountRaw": "1000000000",
    "amountTokens": "1.0",
    "tokenDecimals": 9,
    "tokenSymbol": "SOL",
    "sourceOwner": "Abc123...",
    "recipientWallet": "Def456...",
    "hops": 7,
    "arrivalSeconds": 300,
    "externalId": "order_12345"
  }'

{
  "id": 42,
  "externalId": "order_12345",
  "supportBundleId": "MH-acme-42",
  "tokenMint": "So111...112",
  "amountRaw": "1000000000",
  "amountTokens": "1.0",
  "sourceOwner": "Abc123...",
  "recipientWallet": "Def456...",
  "fundingStrategy": "direct_orchestration",
  "hops": 7,
  "arrivalSeconds": 300,
  "pricingTier": "standard",
  "percentFeeBps": 50,
  "totalFlatFeeLamports": 42000,
  "status": "quote",
  "isTest": false,
  "quotedAt": "2025-01-15T10:30:00.000Z",
  "expiresAt": "2025-01-15T11:00:00.000Z",
  "createdAt": "2025-01-15T10:30:00.000Z"
}

{
  "error": {
    "code": "MH_033",
    "message": "Transfer already exists for externalId 'order_12345'"
  }
}

POST

api

transfers

curl -X POST /api/v1/transfers \
  -H "x-api-key: mh_live_abc123..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "tokenMint": "So11111111111111111111111111111111111111112",
    "amountRaw": "1000000000",
    "amountTokens": "1.0",
    "tokenDecimals": 9,
    "tokenSymbol": "SOL",
    "sourceOwner": "Abc123...",
    "recipientWallet": "Def456...",
    "hops": 7,
    "arrivalSeconds": 300,
    "externalId": "order_12345"
  }'

{
  "id": 42,
  "externalId": "order_12345",
  "supportBundleId": "MH-acme-42",
  "tokenMint": "So111...112",
  "amountRaw": "1000000000",
  "amountTokens": "1.0",
  "sourceOwner": "Abc123...",
  "recipientWallet": "Def456...",
  "fundingStrategy": "direct_orchestration",
  "hops": 7,
  "arrivalSeconds": 300,
  "pricingTier": "standard",
  "percentFeeBps": 50,
  "totalFlatFeeLamports": 42000,
  "status": "quote",
  "isTest": false,
  "quotedAt": "2025-01-15T10:30:00.000Z",
  "expiresAt": "2025-01-15T11:00:00.000Z",
  "createdAt": "2025-01-15T10:30:00.000Z"
}

{
  "error": {
    "code": "MH_033",
    "message": "Transfer already exists for externalId 'order_12345'"
  }
}

Creates a new transfer in quote status with locked-in pricing. Call /prepare next to get the unsigned transactions. Idempotent via externalId — the same externalId returns the existing transfer rather than creating a duplicate.

On compliance-enabled networks the route is screened automatically after deployment and a flat 0.002 SOL screening fee is charged at deploy. You don’t take any action to pass screening — see Compliance & screening for the lifecycle, funding impact, and what happens if a wallet is flagged.

Request body

string

required

The Solana mint address of the token to transfer.

string

required

Raw token amount as a string (e.g. "1000000000" for 1 SOL).

string

required

Human-readable token amount (e.g. "1.0").

string

required

Solana public key of the wallet that will sign and pay for the deployment transactions.

string

required

Solana public key of the final recipient.

integer

default:"6"

Decimal precision of the token (0–18).

string

Token symbol (e.g. "SOL"). Optional, used for display purposes.

integer

Number of intermediate abstraction hops (3–10). Defaults to the integration setting.

integer

Target transfer arrival time in seconds. Minimum: 60.

string

Your own identifier for idempotency (e.g. "order_12345"). Alphanumeric, ., _, - only.

number

Optional token price in USD. If not provided, resolved from Raydium spot pricing.

Response

integer

Internal transfer ID.

string

Your external ID, if provided.

string

Human-readable support reference (e.g. "MH-acme-42").

string

Mint address of the token being transferred.

string

Transfer amount in base units.

string

Human-readable token amount.

string

Solana public key of the signing wallet.

string

Solana public key of the final recipient.

string

Internal funding strategy (e.g. "direct_orchestration").

integer

Number of abstraction hops.

integer

Target arrival time in seconds.

string

Pricing tier applied.

integer

Percentage fee in basis points.

integer

Total flat fee in lamports.

string

Transfer status. Initially quote.

boolean

Whether created with a test-mode API key.

string

ISO 8601 timestamp when pricing was quoted.

string

ISO 8601 timestamp after which the transfer expires if not funded.

string

ISO 8601 creation timestamp.

curl -X POST /api/v1/transfers \
  -H "x-api-key: mh_live_abc123..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "tokenMint": "So11111111111111111111111111111111111111112",
    "amountRaw": "1000000000",
    "amountTokens": "1.0",
    "tokenDecimals": 9,
    "tokenSymbol": "SOL",
    "sourceOwner": "Abc123...",
    "recipientWallet": "Def456...",
    "hops": 7,
    "arrivalSeconds": 300,
    "externalId": "order_12345"
  }'

{
  "id": 42,
  "externalId": "order_12345",
  "supportBundleId": "MH-acme-42",
  "tokenMint": "So111...112",
  "amountRaw": "1000000000",
  "amountTokens": "1.0",
  "sourceOwner": "Abc123...",
  "recipientWallet": "Def456...",
  "fundingStrategy": "direct_orchestration",
  "hops": 7,
  "arrivalSeconds": 300,
  "pricingTier": "standard",
  "percentFeeBps": 50,
  "totalFlatFeeLamports": 42000,
  "status": "quote",
  "isTest": false,
  "quotedAt": "2025-01-15T10:30:00.000Z",
  "expiresAt": "2025-01-15T11:00:00.000Z",
  "createdAt": "2025-01-15T10:30:00.000Z"
}

{
  "error": {
    "code": "MH_033",
    "message": "Transfer already exists for externalId 'order_12345'"
  }
}

API documentation

Transfers

Webhooks

Integration

Request body

Response

​Request body

​Response

Request body

Response