Request quotes
curl --request POST \
--url https://apimonaco.xyz/api/v1/rfqs \
--header 'Content-Type: application/json' \
--header 'X-Monaco-Signature: <api-key>' \
--data '
{
"idempotencyKey": "<string>",
"tradingPairId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"product": "PERPETUAL",
"quantity": "25",
"side": "<string>",
"leverage": "5",
"marginMode": "<string>"
}
'import requests
url = "https://apimonaco.xyz/api/v1/rfqs"
payload = {
"idempotencyKey": "<string>",
"tradingPairId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"product": "PERPETUAL",
"quantity": "25",
"side": "<string>",
"leverage": "5",
"marginMode": "<string>"
}
headers = {
"X-Monaco-Signature": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Monaco-Signature': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
idempotencyKey: '<string>',
tradingPairId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
product: 'PERPETUAL',
quantity: '25',
side: '<string>',
leverage: '5',
marginMode: '<string>'
})
};
fetch('https://apimonaco.xyz/api/v1/rfqs', 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://apimonaco.xyz/api/v1/rfqs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'idempotencyKey' => '<string>',
'tradingPairId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'product' => 'PERPETUAL',
'quantity' => '25',
'side' => '<string>',
'leverage' => '5',
'marginMode' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://apimonaco.xyz/api/v1/rfqs"
payload := strings.NewReader("{\n \"idempotencyKey\": \"<string>\",\n \"tradingPairId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"product\": \"PERPETUAL\",\n \"quantity\": \"25\",\n \"side\": \"<string>\",\n \"leverage\": \"5\",\n \"marginMode\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Monaco-Signature", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://apimonaco.xyz/api/v1/rfqs")
.header("X-Monaco-Signature", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"idempotencyKey\": \"<string>\",\n \"tradingPairId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"product\": \"PERPETUAL\",\n \"quantity\": \"25\",\n \"side\": \"<string>\",\n \"leverage\": \"5\",\n \"marginMode\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://apimonaco.xyz/api/v1/rfqs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Monaco-Signature"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"idempotencyKey\": \"<string>\",\n \"tradingPairId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"product\": \"PERPETUAL\",\n \"quantity\": \"25\",\n \"side\": \"<string>\",\n \"leverage\": \"5\",\n \"marginMode\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"terms": {
"rfqId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tradingPairId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"product": "<string>",
"quantity": "<string>",
"createdAtMs": 123,
"deadlineAtMs": 123,
"side": "<string>",
"leverage": "<string>",
"marginMode": "<string>",
"quoteSide": "<string>"
},
"state": "<string>",
"stateVersion": 123,
"acceptedSide": "<string>",
"lastLookDeadlineAtMs": 123,
"view": {
"viewVersion": 123,
"bid": {
"vwap": "<string>",
"availableQuantity": "<string>",
"grossVwap": "<string>",
"estimatedMonacoFee": "<string>",
"estimatedBuilderFee": "<string>",
"estimatedTotalFee": "<string>",
"book": {
"vwap": "<string>",
"grossVwap": "<string>",
"asOfMs": 123,
"levels": 123
}
},
"ask": {
"vwap": "<string>",
"availableQuantity": "<string>",
"grossVwap": "<string>",
"estimatedMonacoFee": "<string>",
"estimatedBuilderFee": "<string>",
"estimatedTotalFee": "<string>",
"book": {
"vwap": "<string>",
"grossVwap": "<string>",
"asOfMs": 123,
"levels": 123
}
},
"asOfMs": 123,
"monacoFeeCbps": 123,
"builderFeeCbps": 123
},
"ownQuote": {
"rfqId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quoteId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"version": 123,
"bid": {
"price": "65000.5",
"capacity": "10"
},
"ask": {
"price": "65000.5",
"capacity": "10"
},
"issuedAtMs": 123,
"validUntilMs": 123,
"leverage": "<string>",
"marginMode": "<string>",
"refusedSides": [
{
"side": "<string>",
"code": "<string>",
"reason": "<string>"
}
]
},
"ownSelection": {
"acceptanceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"takerSide": "<string>",
"quoteId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quoteVersion": 123,
"quantity": "<string>",
"frozenTerms": {
"price": "65000.5",
"capacity": "10"
},
"lastLookDeadlineAtMs": 123,
"monacoFeeCbps": 123,
"maxBuilderFeeCbps": 123,
"estimatedNet": "<string>"
},
"ownLatestVersion": 123,
"ownQuoteWithdrawn": true,
"outcome": {
"executedQuantity": "<string>",
"unfilledQuantity": "<string>",
"vwap": "<string>",
"fills": [
{
"executionId": "<string>",
"price": "<string>",
"quantity": "<string>",
"fee": "<string>",
"monacoFee": "<string>",
"builderFee": "<string>"
}
],
"allInVwap": "<string>",
"bookAtFill": {
"vwap": "<string>",
"grossVwap": "<string>",
"asOfMs": 123,
"levels": 123
},
"bookAtFillFullSize": true
},
"durableSequence": 123,
"ownFills": [
{
"executionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"price": "<string>",
"quantity": "<string>",
"fee": "<string>",
"monacoFee": "<string>",
"builderFee": "<string>"
}
],
"acceptance": {
"viewVersion": 123,
"acceptedAtMs": 123,
"vwap": "<string>",
"grossVwap": "<string>",
"availableQuantity": "<string>",
"monacoFeeCbps": 123,
"builderFeeCbps": 123,
"book": {
"vwap": "<string>",
"grossVwap": "<string>",
"asOfMs": 123,
"levels": 123
},
"bookFullSize": true
}
}RFQ
Request quotes
Request quotes.
Opens an RFQ for up to quantity on a market. Without a side the request
is two-way and makers never see the taker’s direction.
POST
/
api
/
v1
/
rfqs
Request quotes
curl --request POST \
--url https://apimonaco.xyz/api/v1/rfqs \
--header 'Content-Type: application/json' \
--header 'X-Monaco-Signature: <api-key>' \
--data '
{
"idempotencyKey": "<string>",
"tradingPairId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"product": "PERPETUAL",
"quantity": "25",
"side": "<string>",
"leverage": "5",
"marginMode": "<string>"
}
'import requests
url = "https://apimonaco.xyz/api/v1/rfqs"
payload = {
"idempotencyKey": "<string>",
"tradingPairId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"product": "PERPETUAL",
"quantity": "25",
"side": "<string>",
"leverage": "5",
"marginMode": "<string>"
}
headers = {
"X-Monaco-Signature": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Monaco-Signature': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
idempotencyKey: '<string>',
tradingPairId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
product: 'PERPETUAL',
quantity: '25',
side: '<string>',
leverage: '5',
marginMode: '<string>'
})
};
fetch('https://apimonaco.xyz/api/v1/rfqs', 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://apimonaco.xyz/api/v1/rfqs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'idempotencyKey' => '<string>',
'tradingPairId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'product' => 'PERPETUAL',
'quantity' => '25',
'side' => '<string>',
'leverage' => '5',
'marginMode' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://apimonaco.xyz/api/v1/rfqs"
payload := strings.NewReader("{\n \"idempotencyKey\": \"<string>\",\n \"tradingPairId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"product\": \"PERPETUAL\",\n \"quantity\": \"25\",\n \"side\": \"<string>\",\n \"leverage\": \"5\",\n \"marginMode\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Monaco-Signature", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://apimonaco.xyz/api/v1/rfqs")
.header("X-Monaco-Signature", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"idempotencyKey\": \"<string>\",\n \"tradingPairId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"product\": \"PERPETUAL\",\n \"quantity\": \"25\",\n \"side\": \"<string>\",\n \"leverage\": \"5\",\n \"marginMode\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://apimonaco.xyz/api/v1/rfqs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Monaco-Signature"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"idempotencyKey\": \"<string>\",\n \"tradingPairId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"product\": \"PERPETUAL\",\n \"quantity\": \"25\",\n \"side\": \"<string>\",\n \"leverage\": \"5\",\n \"marginMode\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"terms": {
"rfqId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tradingPairId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"product": "<string>",
"quantity": "<string>",
"createdAtMs": 123,
"deadlineAtMs": 123,
"side": "<string>",
"leverage": "<string>",
"marginMode": "<string>",
"quoteSide": "<string>"
},
"state": "<string>",
"stateVersion": 123,
"acceptedSide": "<string>",
"lastLookDeadlineAtMs": 123,
"view": {
"viewVersion": 123,
"bid": {
"vwap": "<string>",
"availableQuantity": "<string>",
"grossVwap": "<string>",
"estimatedMonacoFee": "<string>",
"estimatedBuilderFee": "<string>",
"estimatedTotalFee": "<string>",
"book": {
"vwap": "<string>",
"grossVwap": "<string>",
"asOfMs": 123,
"levels": 123
}
},
"ask": {
"vwap": "<string>",
"availableQuantity": "<string>",
"grossVwap": "<string>",
"estimatedMonacoFee": "<string>",
"estimatedBuilderFee": "<string>",
"estimatedTotalFee": "<string>",
"book": {
"vwap": "<string>",
"grossVwap": "<string>",
"asOfMs": 123,
"levels": 123
}
},
"asOfMs": 123,
"monacoFeeCbps": 123,
"builderFeeCbps": 123
},
"ownQuote": {
"rfqId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quoteId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"version": 123,
"bid": {
"price": "65000.5",
"capacity": "10"
},
"ask": {
"price": "65000.5",
"capacity": "10"
},
"issuedAtMs": 123,
"validUntilMs": 123,
"leverage": "<string>",
"marginMode": "<string>",
"refusedSides": [
{
"side": "<string>",
"code": "<string>",
"reason": "<string>"
}
]
},
"ownSelection": {
"acceptanceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"takerSide": "<string>",
"quoteId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"quoteVersion": 123,
"quantity": "<string>",
"frozenTerms": {
"price": "65000.5",
"capacity": "10"
},
"lastLookDeadlineAtMs": 123,
"monacoFeeCbps": 123,
"maxBuilderFeeCbps": 123,
"estimatedNet": "<string>"
},
"ownLatestVersion": 123,
"ownQuoteWithdrawn": true,
"outcome": {
"executedQuantity": "<string>",
"unfilledQuantity": "<string>",
"vwap": "<string>",
"fills": [
{
"executionId": "<string>",
"price": "<string>",
"quantity": "<string>",
"fee": "<string>",
"monacoFee": "<string>",
"builderFee": "<string>"
}
],
"allInVwap": "<string>",
"bookAtFill": {
"vwap": "<string>",
"grossVwap": "<string>",
"asOfMs": 123,
"levels": 123
},
"bookAtFillFullSize": true
},
"durableSequence": 123,
"ownFills": [
{
"executionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"price": "<string>",
"quantity": "<string>",
"fee": "<string>",
"monacoFee": "<string>",
"builderFee": "<string>"
}
],
"acceptance": {
"viewVersion": 123,
"acceptedAtMs": 123,
"vwap": "<string>",
"grossVwap": "<string>",
"availableQuantity": "<string>",
"monacoFeeCbps": 123,
"builderFeeCbps": 123,
"book": {
"vwap": "<string>",
"grossVwap": "<string>",
"asOfMs": 123,
"levels": 123
},
"bookFullSize": true
}
}Authorizations
monacoSignaturemonacoHttpSignature
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.
Body
application/json
Client key: a retry with the same key and body returns the first result
Trading pair UUID
SPOT or PERPETUAL
Example:
"PERPETUAL"
Maximum base quantity, exact decimal string
Example:
"25"
BUY or SELL for a one-way RFQ: makers see it and may quote only the side that fills it (an ask when you buy, a bid when you sell). Absent for a two-way RFQ, whose direction stays hidden from makers
Perpetuals: the leverage the taker's order takes when it accepts, as on an order (refused on spot). For a two-way RFQ it applies to whichever side is accepted
Example:
"5"
Perpetuals: ISOLATED (the default) or CROSS, as on an order
Response
OK
Authoritative RFQ status.
The request as created.
Show child attributes
Show child attributes
COLLECTING, LAST_LOOK, RISK_CLEARING, CONFIRMED, SETTLED, CANCELLED, EXPIRED or REJECTED
BUY or SELL, once accepted
The taker's current view of the quotes.
Show child attributes
Show child attributes
A quote version as its maker sees it.
Show child attributes
Show child attributes
A selected maker's own part of an acceptance, for answering last look.
Show child attributes
Show child attributes
The expected version for the caller's next quote or withdrawal
What an accepted RFQ executed.
Show child attributes
Show child attributes
Maker only: your own fills once the RFQ settled, never another maker's
Show child attributes
Show child attributes
What your view showed on the accepted side when you accepted.
Show child attributes
Show child attributes
Was this page helpful?