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
}
Transfers
Estimate Fees
Estimate fees for a potential transfer without creating one
POST
/
api
/
v1
/
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.
string
Integrator’s share of the percentage fee in raw token units.
integer
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
}