Request Settlement Facility
curl --request POST \
--url https://api.mansa.xyz/api/v2/liquidity/management/settlement-facility \
--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": "50000",
"chain_id": "37361842-8d00-4f85-aaa2-5d0c014f303d"
}
'import requests
url = "https://api.mansa.xyz/api/v2/liquidity/management/settlement-facility"
payload = {
"client_id": "550e8400-e29b-41d4-a716-446655440000",
"client_request_id": "7f3d9a4b-1c2e-4f5a-8b6d-0e1f2a3b4c5d",
"amount": "50000",
"chain_id": "37361842-8d00-4f85-aaa2-5d0c014f303d"
}
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: '50000',
chain_id: '37361842-8d00-4f85-aaa2-5d0c014f303d'
})
};
fetch('https://api.mansa.xyz/api/v2/liquidity/management/settlement-facility', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"settlement_facility_request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "PROCESSING",
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}{
"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
Request Settlement Facility
Submit a new settlement facility request (V2 equivalent of loan request).
POST
/
api
/
v2
/
liquidity
/
management
/
settlement-facility
Request Settlement Facility
curl --request POST \
--url https://api.mansa.xyz/api/v2/liquidity/management/settlement-facility \
--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": "50000",
"chain_id": "37361842-8d00-4f85-aaa2-5d0c014f303d"
}
'import requests
url = "https://api.mansa.xyz/api/v2/liquidity/management/settlement-facility"
payload = {
"client_id": "550e8400-e29b-41d4-a716-446655440000",
"client_request_id": "7f3d9a4b-1c2e-4f5a-8b6d-0e1f2a3b4c5d",
"amount": "50000",
"chain_id": "37361842-8d00-4f85-aaa2-5d0c014f303d"
}
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: '50000',
chain_id: '37361842-8d00-4f85-aaa2-5d0c014f303d'
})
};
fetch('https://api.mansa.xyz/api/v2/liquidity/management/settlement-facility', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"settlement_facility_request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "PROCESSING",
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}{
"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