Skip to content

docs(mintlify): correct exchangeRate example basis (PROD-50) #640

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Ethan-Minghao wants to merge 1 commit into
base: main
Choose a base branch
from
+10 −10
Open

docs(mintlify): correct exchangeRate example basis (PROD-50) #640

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions mintlify/platform-overview/core-concepts/currencies-and-rails.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -71,12 +71,12 @@ POST /quotes
"decimals": 2
},
"totalSendingAmount": 100000,
"totalReceivingAmount": 1725000,
"exchangeRate": 17.25,
"totalReceivingAmount": 1716375,
"exchangeRate": 0.05797101,
"feesIncluded": 500,
"transactionId": "Transaction:019542f5-b3e7-1d02-0000-000000000025"
}
```
</Accordion>

This shows: Send $1,000 → Receive $17,250 (at rate 17.25), $5 fee.
This shows: Send $1,000 → Receive $17,163.75 (1 USD ≈ 17.25 MXN, or exchangeRate: 0.05797101), $5 fee.
14 changes: 7 additions & 7 deletions mintlify/platform-overview/core-concepts/quote-system.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -95,14 +95,14 @@ curl -X POST https://api.lightspark.com/grid/2025-10-13/quotes \
"decimals": 8
},
"totalSendingAmount": 100000,
"totalReceivingAmount": 829167,
"exchangeRate": 0.00000833,
"totalReceivingAmount": 828835,
"exchangeRate": 120048.01920768,
"feesIncluded": 500,
"transactionId": "Transaction:019542f5-b3e7-1d02-0000-000000000025"
}
```

This quote says: Send \$1,000 USD, recipient receives 0.00829167 BTC, fees are \$5.00, expires in 5 minutes.
This quote says: Send \$1,000 USD, recipient receives 0.00828835 BTC, fees are \$5.00, expires in 5 minutes.

### Locked Currency Side

Expand Down Expand Up @@ -289,7 +289,7 @@ curl -X POST https://api.lightspark.com/grid/2025-10-13/quotes \
},
"totalSendingAmount": 100000,
"totalReceivingAmount": 91540,
"exchangeRate": 0.92,
"exchangeRate": 1.08695652,
"feesIncluded": 500,
"transactionId": "Transaction:019542f5-b3e7-1d02-0000-000000000025"
}
Expand Down Expand Up @@ -322,7 +322,7 @@ All fees are transparently displayed in the quote response:
"gridApiMultiplier": 0.925,
"gridApiFixedFee": 10,
"gridApiVariableFeeRate": 0.003,
"gridApiVariableFeeAmount": 30
"gridApiVariableFeeAmount": 300
}
}
```
Expand All @@ -333,13 +333,13 @@ All fees are transparently displayed in the quote response:
- **`gridApiMultiplier`**: Exchange rate from sending currency to mSATs including variable fees (0.925 = $1 USD = 0.925 mSATs)
- **`gridApiFixedFee`**: Fixed fee charged by Grid API (10 cents USD)
- **`gridApiVariableFeeRate`**: Variable fee rate as percentage (0.003 = 0.3%)
- **`gridApiVariableFeeAmount`**: Variable fee amount (30 cents USD for $1,000 transaction)
- **`gridApiVariableFeeAmount`**: Variable fee amount (300 cents USD for $1,000 transaction)

Fees are deducted from the sending amount, so:
- **Customer sends**: $1,000
- **Fees**: $5.00
- **Amount converted**: $995.00
- **Recipient receives**: €915.40 (at 0.92 rate)
- **Recipient receives**: €915.40 (1 USD ≈ 0.92 EUR, or exchangeRate: 1.08695652)

<Note>
Quoted fees may fluctuate between quotes. Some fee components (e.g.
Expand Down