Create Withdrawal Request
curl --request POST \
--url https://api.mansa.xyz/api/v2/liquidity/management/withdrawal-requests \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"client_id": "550e8400-e29b-41d4-a716-446655440000",
"client_request_id": "7f3d9a4b-1c2e-4f5a-8b6d-0e1f2a3b4c5d",
"amount": "10000",
"chain_id": "37361842-8d00-4f85-aaa2-5d0c014f303d",
"wallet_id": "abc12345-0000-0000-0000-def123456789",
"accepted_advanced_notice": true
}
'import requests
url = "https://api.mansa.xyz/api/v2/liquidity/management/withdrawal-requests"
payload = {
"client_id": "550e8400-e29b-41d4-a716-446655440000",
"client_request_id": "7f3d9a4b-1c2e-4f5a-8b6d-0e1f2a3b4c5d",
"amount": "10000",
"chain_id": "37361842-8d00-4f85-aaa2-5d0c014f303d",
"wallet_id": "abc12345-0000-0000-0000-def123456789",
"accepted_advanced_notice": True
}
headers = {
"x-api-key": "<api-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-api-key': '<api-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
client_id: '550e8400-e29b-41d4-a716-446655440000',
client_request_id: '7f3d9a4b-1c2e-4f5a-8b6d-0e1f2a3b4c5d',
amount: '10000',
chain_id: '37361842-8d00-4f85-aaa2-5d0c014f303d',
wallet_id: 'abc12345-0000-0000-0000-def123456789',
accepted_advanced_notice: true
})
};
fetch('https://api.mansa.xyz/api/v2/liquidity/management/withdrawal-requests', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "<string>"
}{
"error": {
"type": "validation_error",
"code": "missing_required_field",
"message": "The 'amount' field is required.",
"param": "amount",
"doc_url": "https://docs.mansa.io/errors/missing_required_field"
}
}{
"error": {
"type": "auth_error",
"code": "invalid_token",
"message": "Bearer token is missing or invalid."
}
}{
"error": {
"type": "validation_error",
"code": "business_rule_violation",
"message": "Requested amount exceeds allowed corridor maximum."
}
}{
"error": {
"type": "rate_limit_error",
"code": "too_many_requests",
"message": "Too many requests. Please retry with exponential backoff."
}
}{
"error": {
"type": "api_error",
"code": "upstream_dependency_error",
"message": "A dependency failed to process the request."
}
}Management
Create Withdrawal Request
Submit a withdrawal request for admin approval (V2 two-phase approval flow).
POST
/
api
/
v2
/
liquidity
/
management
/
withdrawal-requests
Create Withdrawal Request
curl --request POST \
--url https://api.mansa.xyz/api/v2/liquidity/management/withdrawal-requests \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"client_id": "550e8400-e29b-41d4-a716-446655440000",
"client_request_id": "7f3d9a4b-1c2e-4f5a-8b6d-0e1f2a3b4c5d",
"amount": "10000",
"chain_id": "37361842-8d00-4f85-aaa2-5d0c014f303d",
"wallet_id": "abc12345-0000-0000-0000-def123456789",
"accepted_advanced_notice": true
}
'import requests
url = "https://api.mansa.xyz/api/v2/liquidity/management/withdrawal-requests"
payload = {
"client_id": "550e8400-e29b-41d4-a716-446655440000",
"client_request_id": "7f3d9a4b-1c2e-4f5a-8b6d-0e1f2a3b4c5d",
"amount": "10000",
"chain_id": "37361842-8d00-4f85-aaa2-5d0c014f303d",
"wallet_id": "abc12345-0000-0000-0000-def123456789",
"accepted_advanced_notice": True
}
headers = {
"x-api-key": "<api-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'x-api-key': '<api-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
client_id: '550e8400-e29b-41d4-a716-446655440000',
client_request_id: '7f3d9a4b-1c2e-4f5a-8b6d-0e1f2a3b4c5d',
amount: '10000',
chain_id: '37361842-8d00-4f85-aaa2-5d0c014f303d',
wallet_id: 'abc12345-0000-0000-0000-def123456789',
accepted_advanced_notice: true
})
};
fetch('https://api.mansa.xyz/api/v2/liquidity/management/withdrawal-requests', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "<string>"
}{
"error": {
"type": "validation_error",
"code": "missing_required_field",
"message": "The 'amount' field is required.",
"param": "amount",
"doc_url": "https://docs.mansa.io/errors/missing_required_field"
}
}{
"error": {
"type": "auth_error",
"code": "invalid_token",
"message": "Bearer token is missing or invalid."
}
}{
"error": {
"type": "validation_error",
"code": "business_rule_violation",
"message": "Requested amount exceeds allowed corridor maximum."
}
}{
"error": {
"type": "rate_limit_error",
"code": "too_many_requests",
"message": "Too many requests. Please retry with exponential backoff."
}
}{
"error": {
"type": "api_error",
"code": "upstream_dependency_error",
"message": "A dependency failed to process the request."
}
}Authorizations
API key for authentication
JWT token following RFC001 specification
Body
application/json
Example:
"10000"
Must be true to confirm acceptance of the Advanced Notice terms before submitting a withdrawal request.