v1
latestOpenAPI 3.0.32026-08-04850206.9 KBCalculators
Profit / loss calculator
What a buy-then-sell between two historical dates returned, using the coin's real prices on those dates. Fees are flat USD amounts, not percentages.
get/api/v1/calculators/profit-loss
Query parameters
slugstring required
The coin's slug identifier.
Example:bitcoin
The coin's slug identifier.
amountnumber required
USD invested at buy_date (0.01–1,000,000,000).
Example:1000
USD invested at buy_date (0.01–1,000,000,000).
buy_datestring required
date Purchase date.
Example:2023-01-01
date Purchase date.
sell_datestring required
date Sale date (on/after buy_date).
Example:2025-01-01
date Sale date (on/after buy_date).
buy_feenumber nullable
Flat purchase fee in USD (default 0).
Example:10
Flat purchase fee in USD (default 0).
sell_feenumber nullable
Flat sale fee in USD (default 0).
Example:10
Flat sale fee in USD (default 0).
Response
Example response
{
"data": {
"buy_price": "16625.08",
"sell_price": "93429.2",
"quantity": 0.0595486254,
"investment_worth": 5563.58,
"total_fees": 20,
"profit": 4553.58,
"roi": 455.36
},
"meta": {
"coin": "bitcoin",
"amount": 1000,
"buy_date": "2023-01-01",
"sell_date": "2025-01-01",
"buy_fee": 10,
"sell_fee": 10,
"currency": "USD"
}
}