curl --request GET \
--url https://staging.apimonaco.xyz/api/v1/fees/simulate \
--header 'X-Monaco-Signature: <api-key>'import requests
url = "https://staging.apimonaco.xyz/api/v1/fees/simulate"
headers = {"X-Monaco-Signature": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Monaco-Signature': '<api-key>'}};
fetch('https://staging.apimonaco.xyz/api/v1/fees/simulate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://staging.apimonaco.xyz/api/v1/fees/simulate",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Monaco-Signature: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://staging.apimonaco.xyz/api/v1/fees/simulate"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Monaco-Signature", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://staging.apimonaco.xyz/api/v1/fees/simulate")
.header("X-Monaco-Signature", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://staging.apimonaco.xyz/api/v1/fees/simulate")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Monaco-Signature"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"notional": "20000.00",
"monacoTakerFee": "20.00",
"monacoMakerRebate": "-5.00",
"applicationTakerFee": "10.00",
"totalTakerFees": "30.00",
"takerTotalPayment": "20030.00",
"makerTotalReceipt": "19995.00",
"buyOrderLockAmount": "20030.00",
"monacoTakerFeeBps": 10,
"monacoMakerRebateBps": -2,
"applicationTakerFeeBps": 5,
"applicationName": "Monaco Trading Frontend",
"maxQuantity": "99.95",
"maxQuantityRaw": "99950000000000000000",
"slippageToleranceBps": 500,
"monacoTakerFeeBpsExact": "6.5",
"monacoMakerRebateBpsExact": "-1"
}Simulate fees for a potential order
Simulate fees for a potential order.
Returns exact fee breakdown for a specific order before placing it, including Monaco protocol fees, application fees, total amounts, and the maximum quantity affordable at the given price.
curl --request GET \
--url https://staging.apimonaco.xyz/api/v1/fees/simulate \
--header 'X-Monaco-Signature: <api-key>'import requests
url = "https://staging.apimonaco.xyz/api/v1/fees/simulate"
headers = {"X-Monaco-Signature": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Monaco-Signature': '<api-key>'}};
fetch('https://staging.apimonaco.xyz/api/v1/fees/simulate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://staging.apimonaco.xyz/api/v1/fees/simulate",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Monaco-Signature: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://staging.apimonaco.xyz/api/v1/fees/simulate"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Monaco-Signature", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://staging.apimonaco.xyz/api/v1/fees/simulate")
.header("X-Monaco-Signature", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://staging.apimonaco.xyz/api/v1/fees/simulate")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Monaco-Signature"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"notional": "20000.00",
"monacoTakerFee": "20.00",
"monacoMakerRebate": "-5.00",
"applicationTakerFee": "10.00",
"totalTakerFees": "30.00",
"takerTotalPayment": "20030.00",
"makerTotalReceipt": "19995.00",
"buyOrderLockAmount": "20030.00",
"monacoTakerFeeBps": 10,
"monacoMakerRebateBps": -2,
"applicationTakerFeeBps": 5,
"applicationName": "Monaco Trading Frontend",
"maxQuantity": "99.95",
"maxQuantityRaw": "99950000000000000000",
"slippageToleranceBps": 500,
"monacoTakerFeeBpsExact": "6.5",
"monacoMakerRebateBpsExact": "-1"
}Authorizations
Ed25519 session-key request signing. Every authenticated request carries three headers: X-Monaco-PublicKey (64-char lowercase-hex session public key), X-Monaco-Timestamp (Unix milliseconds, within 30s of server time), and X-Monaco-Signature (hex ed25519 signature). The signature is over METHOD\npath?query\ntimestamp_ms\nSHA256_hex(body), where the body hash is the SHA-256 of the empty byte string when there is no body. Obtain the session keypair from POST /api/v1/auth/challenge followed by POST /api/v1/auth/verify.
Query Parameters
Trading pair identifier (UUID)
1Order side
BUY, SELL 1Price as decimal string
1Quantity as decimal string
1Order type
LIMIT, MARKET, STOP_LOSS, TAKE_PROFIT, STOP_LIMIT, TRAILING_STOP 1Response
OK
Notional value (price x quantity)
"20000.00"
Monaco protocol taker fee in quote token
"20.00"
Monaco maker rebate in quote token (negative)
"-5.00"
Application-specific taker fee in quote token
"10.00"
Total taker fees (monaco + application)
"30.00"
Total amount paid by taker (notional + fees)
"20030.00"
Total amount received by maker (notional - rebate)
"19995.00"
Amount locked for buy orders. For MARKET orders, includes slippage buffer.
"20030.00"
DEPRECATED: whole-basis-points taker rate. An integer cannot represent fractional tiered rates (e.g. 6.5), so this echoes the flat trading_pairs column, NOT the tier-resolved rate the ledger charges. Kept for backward compatibility. Use monaco_taker_fee_bps_exact (or GET /api/v1/fees/tier).
10
DEPRECATED: whole-basis-points maker rebate. An integer cannot represent fractional tiered rebates (e.g. -1.15), so this echoes the flat trading_pairs column, NOT the tier-resolved rate. Kept for backward compatibility. Use monaco_maker_rebate_bps_exact (or GET /api/v1/fees/tier).
-2
Application taker fee rate in basis points
5
Application display name
"Monaco Trading Frontend"
Maximum quantity affordable at the given price, accounting for fees and slippage. Powers the 100% range input on the FE.
"99.95"
Maximum quantity in RAW (smallest unit) format
"99950000000000000000"
Slippage tolerance used in the calculation (echoed back)
500
Tier-resolved Monaco taker fee rate as a decimal basis-points string — the exact rate the ledger charges this caller (equals monaco_taker_fee / notional). Fractional and per-tier, e.g. "6.5". Prefer this over the deprecated integer monaco_taker_fee_bps.
"6.5"
Tier-resolved Monaco maker rebate as a decimal basis-points string (negative is a rebate) — the exact rate the ledger credits this caller. Fractional and per-tier, e.g. "-1". Prefer this over the deprecated integer monaco_maker_rebate_bps.
"-1"
Was this page helpful?

