curl --request POST \
--url https://apimonaco.xyz/api/v1/margin/collateral/transfer \
--header 'Content-Type: application/json' \
--header 'X-Monaco-Signature: <api-key>' \
--data '
{
"asset": "<string>",
"amount": "<string>",
"from": {
"wallet": true,
"marginAccountId": "<string>",
"riskBucketId": "<string>"
},
"to": {
"wallet": true,
"marginAccountId": "<string>",
"riskBucketId": "<string>"
},
"idempotencyKey": "<string>"
}
'import requests
url = "https://apimonaco.xyz/api/v1/margin/collateral/transfer"
payload = {
"asset": "<string>",
"amount": "<string>",
"from": {
"wallet": True,
"marginAccountId": "<string>",
"riskBucketId": "<string>"
},
"to": {
"wallet": True,
"marginAccountId": "<string>",
"riskBucketId": "<string>"
},
"idempotencyKey": "<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({
asset: '<string>',
amount: '<string>',
from: {wallet: true, marginAccountId: '<string>', riskBucketId: '<string>'},
to: {wallet: true, marginAccountId: '<string>', riskBucketId: '<string>'},
idempotencyKey: '<string>'
})
};
fetch('https://apimonaco.xyz/api/v1/margin/collateral/transfer', 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/margin/collateral/transfer",
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([
'asset' => '<string>',
'amount' => '<string>',
'from' => [
'wallet' => true,
'marginAccountId' => '<string>',
'riskBucketId' => '<string>'
],
'to' => [
'wallet' => true,
'marginAccountId' => '<string>',
'riskBucketId' => '<string>'
],
'idempotencyKey' => '<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/margin/collateral/transfer"
payload := strings.NewReader("{\n \"asset\": \"<string>\",\n \"amount\": \"<string>\",\n \"from\": {\n \"wallet\": true,\n \"marginAccountId\": \"<string>\",\n \"riskBucketId\": \"<string>\"\n },\n \"to\": {\n \"wallet\": true,\n \"marginAccountId\": \"<string>\",\n \"riskBucketId\": \"<string>\"\n },\n \"idempotencyKey\": \"<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/margin/collateral/transfer")
.header("X-Monaco-Signature", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"asset\": \"<string>\",\n \"amount\": \"<string>\",\n \"from\": {\n \"wallet\": true,\n \"marginAccountId\": \"<string>\",\n \"riskBucketId\": \"<string>\"\n },\n \"to\": {\n \"wallet\": true,\n \"marginAccountId\": \"<string>\",\n \"riskBucketId\": \"<string>\"\n },\n \"idempotencyKey\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://apimonaco.xyz/api/v1/margin/collateral/transfer")
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 \"asset\": \"<string>\",\n \"amount\": \"<string>\",\n \"from\": {\n \"wallet\": true,\n \"marginAccountId\": \"<string>\",\n \"riskBucketId\": \"<string>\"\n },\n \"to\": {\n \"wallet\": true,\n \"marginAccountId\": \"<string>\",\n \"riskBucketId\": \"<string>\"\n },\n \"idempotencyKey\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"movementId": "<string>",
"amount": "<string>",
"fromMarginAccountId": "<string>",
"toMarginAccountId": "<string>",
"toRiskBucketId": "<string>",
"fromRiskBucketId": "<string>",
"positionMarginCredited": true
}Post apiv1margincollateraltransfer
Move collateral between any two of the caller’s places: the spot wallet, a
margin account, a risk bucket. from and to each name the wallet or a
margin account (optionally one of its risk buckets). A route that crosses
accounts or the wallet runs up to three moves in one step: out of the risk
bucket, across to the other account, into the destination. The wallet is
reached through the default margin account. A refused request moves nothing.
A route to or from the wallet or a risk bucket refuses a copy-trading
sub-account. If the service fails partway, the request answers
COLLATERAL_TRANSFER_STOPPED_PARTWAY (HTTP 409 / gRPC ALREADY_EXISTS) naming
the margin account that holds the amount: move it from there rather than
retrying, and re-read the wallet balance. The older transfer routes keep
working unchanged.
curl --request POST \
--url https://apimonaco.xyz/api/v1/margin/collateral/transfer \
--header 'Content-Type: application/json' \
--header 'X-Monaco-Signature: <api-key>' \
--data '
{
"asset": "<string>",
"amount": "<string>",
"from": {
"wallet": true,
"marginAccountId": "<string>",
"riskBucketId": "<string>"
},
"to": {
"wallet": true,
"marginAccountId": "<string>",
"riskBucketId": "<string>"
},
"idempotencyKey": "<string>"
}
'import requests
url = "https://apimonaco.xyz/api/v1/margin/collateral/transfer"
payload = {
"asset": "<string>",
"amount": "<string>",
"from": {
"wallet": True,
"marginAccountId": "<string>",
"riskBucketId": "<string>"
},
"to": {
"wallet": True,
"marginAccountId": "<string>",
"riskBucketId": "<string>"
},
"idempotencyKey": "<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({
asset: '<string>',
amount: '<string>',
from: {wallet: true, marginAccountId: '<string>', riskBucketId: '<string>'},
to: {wallet: true, marginAccountId: '<string>', riskBucketId: '<string>'},
idempotencyKey: '<string>'
})
};
fetch('https://apimonaco.xyz/api/v1/margin/collateral/transfer', 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/margin/collateral/transfer",
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([
'asset' => '<string>',
'amount' => '<string>',
'from' => [
'wallet' => true,
'marginAccountId' => '<string>',
'riskBucketId' => '<string>'
],
'to' => [
'wallet' => true,
'marginAccountId' => '<string>',
'riskBucketId' => '<string>'
],
'idempotencyKey' => '<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/margin/collateral/transfer"
payload := strings.NewReader("{\n \"asset\": \"<string>\",\n \"amount\": \"<string>\",\n \"from\": {\n \"wallet\": true,\n \"marginAccountId\": \"<string>\",\n \"riskBucketId\": \"<string>\"\n },\n \"to\": {\n \"wallet\": true,\n \"marginAccountId\": \"<string>\",\n \"riskBucketId\": \"<string>\"\n },\n \"idempotencyKey\": \"<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/margin/collateral/transfer")
.header("X-Monaco-Signature", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"asset\": \"<string>\",\n \"amount\": \"<string>\",\n \"from\": {\n \"wallet\": true,\n \"marginAccountId\": \"<string>\",\n \"riskBucketId\": \"<string>\"\n },\n \"to\": {\n \"wallet\": true,\n \"marginAccountId\": \"<string>\",\n \"riskBucketId\": \"<string>\"\n },\n \"idempotencyKey\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://apimonaco.xyz/api/v1/margin/collateral/transfer")
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 \"asset\": \"<string>\",\n \"amount\": \"<string>\",\n \"from\": {\n \"wallet\": true,\n \"marginAccountId\": \"<string>\",\n \"riskBucketId\": \"<string>\"\n },\n \"to\": {\n \"wallet\": true,\n \"marginAccountId\": \"<string>\",\n \"riskBucketId\": \"<string>\"\n },\n \"idempotencyKey\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"movementId": "<string>",
"amount": "<string>",
"fromMarginAccountId": "<string>",
"toMarginAccountId": "<string>",
"toRiskBucketId": "<string>",
"fromRiskBucketId": "<string>",
"positionMarginCredited": true
}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.
Body
Optional submission identity, shared with order create (same 1-64 characters from [A-Za-z0-9._:-], same per user and application namespace). Retrying the same key and request within 15 minutes of the original acceptance returns the original transfer result, including its movementId, without moving money again; balance figures in a replayed response are as of the retry. The same key with a different request, or a key already used on another endpoint, returns IDEMPOTENCY_KEY_CONFLICT (HTTP 409 / gRPC ALREADY_EXISTS). ORDER_SUBMISSION_UNAVAILABLE and ORDER_SUBMISSION_CAPACITY_EXCEEDED (HTTP 503 / gRPC UNAVAILABLE) mean the outcome is held but cannot be read, or no new key can be accepted: retry with the same key and request. The window does not extend on retries; after it the key moves money again. Generate a fresh key for each intended transfer and keep it across retries of that transfer.
Response
OK
Was this page helpful?

