Create a Market Maker

POST /exchange/market-makers

​

Request

• Headers: Authorization: Bearer <token>

• Body (required):

  • Media Type: application/json

{
  "business_id": "7da8e726-a1bc-11ee-80cf-560f156a658b",
  "contacts": [
    {
      "id": "7da8e726-a1bc-11ee-80cf-560f156a658b",
      "type": "user"
    }
  ],
  "swap_provider": true,
  "swap_weight": 50
}

​

Fields:

• business_id (string, required): The ID of the business to be assigned as a market maker.

• contacts (array of objects, required): A list of associated contact users.

• id (string, required): Contact user ID.

• type (string, required): The type of contact (e.g., user).

• swap_provider (boolean, required): Indicates if the market maker provides swaps.

• swap_weight (integer, required): The weight or priority for the swap service (e.g., 0–100).

​

Responses:

201 Created

1. Media Type: application/json

2. Sample Response:

{
  "data": {
    "archived": false,
    "contacts": [
      {
        "email": "test@user.com",
        "id": "7da8e726-a1bc-11ee-80cf-560f156a658b",
        "name": "Test User",
        "type": "user"
      }
    ],
    "email": "anon@nymous.com",
    "entity": {
      "id": "6ebe0a0f-bb8f-49be-80ea-c6b72c348fea",
      "type": "business"
    },
    "id": "7da75a46-a1bc-11ee-9a32-560f156a658b",
    "name": "Anon Nymous",
    "swap_provider": false,
    "swap_weight": 0
  }
}

• 400 Bad Request- Returned if the request contains invalid data.

• 403 Forbidden- Returned if the user is not authorized to create a market maker.

• 422 Unprocessable Entity- Returned if required fields are missing or invalid.