💰 Fee Management

Fee configuration and rate management endpoints. 4 endpoints available.

🎯 Quick Stats

Total Endpoints: 4
Base URL: https://api.market.decenctype.com
Authentication: Bearer Token / API Key

📊 Methods

🔍 GET: 2 endpoints
📝 POST: 1 endpoints
✏️ PUT: 1 endpoints

🔐 Authentication

All endpoints in this section use the same authentication methods. Choose one:

🔑 Bearer Token (Recommended)

For user session authentication

Add to request headers:

Authorization: Bearer YOUR_TOKEN

🔧 API Key

For server-side authentication

Add to request headers:

X-API-KEY: YOUR_API_KEY

⚠️ Important: Do not use both authentication methods simultaneously in the same request.

🔗 Endpoints Overview

Method	Endpoint	Description
🔍 `GET`	`/fee/user/{userId}`	Get user fee rate
🔍 `GET`	`/fee`	Get fee configurations list
📝 `POST`	`/fee`	Create fee configuration
✏️ `PUT`	`/fee/{feeId}`	Update fee configuration

📖 Detailed Documentation

Get user fee rate

GET/fee/user/{userId}

Full URL

https://api.market.decenctype.com/fee/user/{userId}

🎯 Path Parameters

userId (string) - ✅ Required: User ID

📋 Query Parameters

Parameter	Type	Required	Description
`feeType`	`string`	❌	Fee type (e.g., exchange, withdrawal) (示例: `exchange`)
`accountType`	`string`	❌	Account type

Description: Get user fee rate

Operation ID: getUserFeeRate

Response Status:

✅ 200: User fee rate retrieved successfully

📋 Response Examples

response.json

1{
2  "id": "123e4567-e89b-12d3-a456-426614174000",
3  "type": "exchange",
4  "level": 1,
5  "exchangeFee": 0.025,
6  "minFee": 2,
7  "maxFee": 100,
8  "groupId": "123e4567-e89b-12d3-a456-426614174000",
9  "merchantId": "123e4567-e89b-12d3-a456-426614174000",
10  "status": "active",
11  "description": "Standard exchange fee for level 1 users",
12  "userGroup": "example-userGroup",
13  "merchant": "example-merchant"
14}

📝 Example Request

curl -X GET "https://api.market.decenctype.com/fee/user/example-id" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Get fee configurations list

GET/fee

Full URL

https://api.market.decenctype.com/fee

📋 Query Parameters

Parameter	Type	Required	Description
`merchantId`	`string`	❌	Filter by merchant ID
`groupId`	`string`	❌	Filter by user group ID
`type`	`string`	❌	Filter by fee type
`status`	`string`	❌	Filter by status
`page`	`number`	❌	No description
`pageSize`	`number`	❌	No description

Description: Get fee configurations list

Operation ID: getFeeConfigurations

Response Status:

✅ 200: Fee configurations retrieved successfully

📋 Response Examples

response.json

1{
2  "rows": [
3    {
4      "id": "123e4567-e89b-12d3-a456-426614174000",
5      "type": "exchange",
6      "level": 1,
7      "exchangeFee": 0.025,
8      "minFee": 2,
9      "status": "active",
10      "userGroup": "example-userGroup",
11      "merchant": "example-merchant"
12    }
13  ],
14  "count": 1
15}

📝 Example Request

curl -X GET "https://api.market.decenctype.com/fee" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Create fee configuration

POST/fee

Full URL

https://api.market.decenctype.com/fee

📝 Request Body Parameters

Parameter	Type	Required	Description
`type`	`string (exchange, withdrawal, deposit, transfer)`	✅	费率类型
`level`	`number`	❌	费率等级 (最小: 0, 最大: 10)
`exchangeFee`	`number`	✅	交易费率 (百分比) (最小: 0, 最大: 100)
`minFee`	`number`	✅	最小费用 (最小: 0)
`maxFee`	`number`	❌	最大费用 (最小: 0)
`groupId`	`string`	❌	用户组ID
`merchantId`	`string`	❌	商户ID
`status`	`string (active, inactive)`	❌	费率状态
`description`	`string`	❌	费率描述 (最大长度: 500)

Description: Create fee configuration

Operation ID: createFeeConfiguration

Response Status:

✅ 201: Fee configuration created successfully

📋 Response Examples

response.json

1{
2  "id": "123e4567-e89b-12d3-a456-426614174000",
3  "type": "exchange",
4  "level": 1,
5  "exchangeFee": 0.025,
6  "minFee": 2,
7  "maxFee": 100,
8  "groupId": "123e4567-e89b-12d3-a456-426614174000",
9  "merchantId": "123e4567-e89b-12d3-a456-426614174000",
10  "status": "active",
11  "description": "Standard exchange fee for level 1 users",
12  "userGroup": "example-userGroup",
13  "merchant": "example-merchant"
14}

📝 Example Request

curl -X POST "https://api.market.decenctype.com/fee" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json" \\
  -d '{
  "type": "exchange",
  "exchangeFee": 0.1,
  "minFee": 1
}'

Update fee configuration

PUT/fee/{feeId}

Full URL

https://api.market.decenctype.com/fee/{feeId}

🎯 Path Parameters

feeId (string) - ✅ Required: Fee configuration ID

📝 Request Body Parameters

Parameter	Type	Required	Description
`type`	`string (exchange, withdrawal, deposit, transfer)`	❌	费率类型
`level`	`number`	❌	费率等级 (最小: 0, 最大: 10)
`exchangeFee`	`number`	❌	交易费率 (百分比) (最小: 0, 最大: 100)
`minFee`	`number`	❌	最小费用 (最小: 0)
`maxFee`	`number`	❌	最大费用 (最小: 0)
`groupId`	`string`	❌	用户组ID
`merchantId`	`string`	❌	商户ID
`status`	`string (active, inactive)`	❌	费率状态
`description`	`string`	❌	费率描述 (最大长度: 500)

Description: Update fee configuration

Operation ID: updateFeeConfiguration

Response Status:

✅ 200: Fee configuration updated successfully

📋 Response Examples

response.json

1{
2  "id": "123e4567-e89b-12d3-a456-426614174000",
3  "type": "exchange",
4  "level": 1,
5  "exchangeFee": 0.025,
6  "minFee": 2,
7  "maxFee": 100,
8  "groupId": "123e4567-e89b-12d3-a456-426614174000",
9  "merchantId": "123e4567-e89b-12d3-a456-426614174000",
10  "status": "active",
11  "description": "Standard exchange fee for level 1 users",
12  "userGroup": "example-userGroup",
13  "merchant": "example-merchant"
14}

📝 Example Request

curl -X PUT "https://api.market.decenctype.com/fee/example-id" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json" \\
  -d '{}'

💰 Fee Management

🎯 Quick Stats

📊 Methods

🔑 Bearer Token (Recommended)

🔧 API Key

On this page