Create offramp quote
Create an exact-in, variable quote to a Cash App username or Lightning address. Returns the normal quote response and deposit instructions; paying creates the order. The recipient is resolved at delivery, so an unavailable account or an amount outside its limits can fail after funding. Completion confirms Lightning delivery. Cash App USD conversion depends on the recipient setting and is not guaranteed. Successful idempotency replays recheck the frozen quote recipient, refund and fee addresses against the current OFAC list without overwriting the successful quote or creating a replacement.
curl --request POST \
--url https://orchestration.flashnet.xyz/v1/orchestration/offramp \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Idempotency-Key: <x-idempotency-key>' \
--data '
{
"sourceChain": "solana",
"sourceAsset": "USDC",
"amount": "50000000",
"recipientAddress": "$username",
"refundAddress": "YOUR_SOURCE_CHAIN_REFUND_ADDRESS"
}
'const options = {
method: 'POST',
headers: {
'X-Idempotency-Key': '<x-idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
sourceChain: 'solana',
sourceAsset: 'USDC',
amount: '50000000',
recipientAddress: '$username',
refundAddress: 'YOUR_SOURCE_CHAIN_REFUND_ADDRESS'
})
};
fetch('https://orchestration.flashnet.xyz/v1/orchestration/offramp', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://orchestration.flashnet.xyz/v1/orchestration/offramp"
payload = {
"sourceChain": "solana",
"sourceAsset": "USDC",
"amount": "50000000",
"recipientAddress": "$username",
"refundAddress": "YOUR_SOURCE_CHAIN_REFUND_ADDRESS"
}
headers = {
"X-Idempotency-Key": "<x-idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"amountMode": "exact_in",
"estimatedOut": "49500",
"feeAmount": "250000",
"roundingFeeAmount": "0",
"totalFeeAmount": "250000",
"feeBps": 50,
"feeAsset": "USDC",
"route": [
"USDC",
"USDB",
"BTC"
],
"quoteId": "q_7e450ab4-935b-4f8d-a6c4-4987a3cd2831",
"depositAddress": "7EcDhSYGxXyscszYEp35KHN8vvw3svAuLKTzXwCFLtV",
"amountIn": "50000000",
"expiresAt": "2026-09-12T12:02:00.000Z",
"source": {
"chain": "solana",
"asset": "USDC",
"assetDisplayName": "USDC",
"assetDisplaySymbol": "USDC",
"contractAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"decimals": 6,
"chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"chainDisplayName": "Solana",
"chainIcon": "/chain-solana.svg"
},
"destination": {
"chain": "lightning",
"asset": "BTC",
"assetDisplayName": "Bitcoin",
"assetDisplaySymbol": "BTC",
"contractAddress": null,
"decimals": 8,
"chainId": null,
"chainDisplayName": "Lightning",
"chainIcon": "/chain-lightning.svg"
}
}Authorizations
Body
Exact-in variable Lightning payout. Unknown fields are rejected.
An AssetInput, or a token address. A quote whose source is an unlisted token requires refundAddress: a deposit that cannot be sold is refunded in kind there.
AAPL, AI, AMD, AMZN, BNB, BONER, BTC, CASHCAT, COIN, COST, DAI, DELTA, DJT, ETH, GLD, GME, GOOGL, GRAM, HIMS, HSUSD, HYPE, IF, LTC, META, MON, MSFT, MSTR, MU, NVDA, OUSD, PIPEDOG, PLTR, POL, PONS, PYUSD, PathUSD, QQQ, RDDT, SHX, SKHY, SLV, SNDK, SOL, SPCX, SPY, STONKBROKER, TENDIES, TRX, TSLA, TSM, UP, USDB, USDC, USDC.e, USDG, USDT, USDe, USDâ‚®0, USO, WBNB, WBTC, WEN, XMR, XO, XPL, XRP, ZEC, cbBTC, tBTC Cash App username (username or $username), or Lightning address (username@domain). Cash App usernames resolve to [email protected]. BOLT11 invoices and URLs are not accepted.
1Response
Quote created
Was this page helpful?
curl --request POST \
--url https://orchestration.flashnet.xyz/v1/orchestration/offramp \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Idempotency-Key: <x-idempotency-key>' \
--data '
{
"sourceChain": "solana",
"sourceAsset": "USDC",
"amount": "50000000",
"recipientAddress": "$username",
"refundAddress": "YOUR_SOURCE_CHAIN_REFUND_ADDRESS"
}
'const options = {
method: 'POST',
headers: {
'X-Idempotency-Key': '<x-idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
sourceChain: 'solana',
sourceAsset: 'USDC',
amount: '50000000',
recipientAddress: '$username',
refundAddress: 'YOUR_SOURCE_CHAIN_REFUND_ADDRESS'
})
};
fetch('https://orchestration.flashnet.xyz/v1/orchestration/offramp', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://orchestration.flashnet.xyz/v1/orchestration/offramp"
payload = {
"sourceChain": "solana",
"sourceAsset": "USDC",
"amount": "50000000",
"recipientAddress": "$username",
"refundAddress": "YOUR_SOURCE_CHAIN_REFUND_ADDRESS"
}
headers = {
"X-Idempotency-Key": "<x-idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"amountMode": "exact_in",
"estimatedOut": "49500",
"feeAmount": "250000",
"roundingFeeAmount": "0",
"totalFeeAmount": "250000",
"feeBps": 50,
"feeAsset": "USDC",
"route": [
"USDC",
"USDB",
"BTC"
],
"quoteId": "q_7e450ab4-935b-4f8d-a6c4-4987a3cd2831",
"depositAddress": "7EcDhSYGxXyscszYEp35KHN8vvw3svAuLKTzXwCFLtV",
"amountIn": "50000000",
"expiresAt": "2026-09-12T12:02:00.000Z",
"source": {
"chain": "solana",
"asset": "USDC",
"assetDisplayName": "USDC",
"assetDisplaySymbol": "USDC",
"contractAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"decimals": 6,
"chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"chainDisplayName": "Solana",
"chainIcon": "/chain-solana.svg"
},
"destination": {
"chain": "lightning",
"asset": "BTC",
"assetDisplayName": "Bitcoin",
"assetDisplaySymbol": "BTC",
"contractAddress": null,
"decimals": 8,
"chainId": null,
"chainDisplayName": "Lightning",
"chainIcon": "/chain-lightning.svg"
}
}