Estimate Fees

curl -X POST /api/v1/transfers/estimate \
  -H "x-api-key: mh_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "tokenMint": "So11111111111111111111111111111111111111112",
    "amountRaw": "1000000000",
    "tokenDecimals": 9,
    "hops": 7
  }'

{
  "tier": "standard",
  "percentFeeBps": 50,
  "percentFeeRaw": "500000",
  "flatFeeLamportsPerHop": 6000,
  "totalFlatFeeLamports": 42000,
  "integratorPercentShare": "250000",
  "integratorFlatShare": 21000,
  "usdEquivalent": 1502.50,
  "isTestMode": false
}

POST

api

transfers

estimate

curl -X POST /api/v1/transfers/estimate \
  -H "x-api-key: mh_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "tokenMint": "So11111111111111111111111111111111111111112",
    "amountRaw": "1000000000",
    "tokenDecimals": 9,
    "hops": 7
  }'

{
  "tier": "standard",
  "percentFeeBps": 50,
  "percentFeeRaw": "500000",
  "flatFeeLamportsPerHop": 6000,
  "totalFlatFeeLamports": 42000,
  "integratorPercentShare": "250000",
  "integratorFlatShare": 21000,
  "usdEquivalent": 1502.50,
  "isTestMode": false
}

Use this endpoint to show users expected costs before they confirm a transfer.

This estimate does not include the compliance screening fee. On networks where the compliance gate is enabled (mainnet today), each deploy also collects a flat refundable screening deposit (currently 0.002 SOL on mainnet) from the signing wallet, charged by the /prepare bundle. Add it on top of the fees returned here when budgeting how much SOL the sourceOwner wallet must hold, otherwise the deploy can fail for insufficient lamports. See Compliance & screening.

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).

integer

default:"6"

Decimal precision of the token. Defaults to 6.

integer

default:"7"

Number of intermediate abstraction hops. Range: 3–10. Defaults to 7.

Response

string

Pricing tier determined by the USD equivalent of the transfer.

integer

Percentage fee in basis points.

string

Percentage fee in raw token units.

integer

Flat fee in lamports charged per hop.

integer

Total flat fee in lamports across all hops.

Integrator’s share of the percentage fee in raw token units.

Integrator’s share of the flat fee in lamports.

number

USD equivalent of the transfer amount at quote time (used for tier selection).

boolean

Whether this estimate was made with a test-mode API key.

curl -X POST /api/v1/transfers/estimate \
  -H "x-api-key: mh_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "tokenMint": "So11111111111111111111111111111111111111112",
    "amountRaw": "1000000000",
    "tokenDecimals": 9,
    "hops": 7
  }'

{
  "tier": "standard",
  "percentFeeBps": 50,
  "percentFeeRaw": "500000",
  "flatFeeLamportsPerHop": 6000,
  "totalFlatFeeLamports": 42000,
  "integratorPercentShare": "250000",
  "integratorFlatShare": 21000,
  "usdEquivalent": 1502.50,
  "isTestMode": false
}

API documentation

Transfers

Webhooks

Integration

Request body

Response

​Request body

​Response

Request body

Response