💳 Wallet Management

Digital wallet, balance, and crypto/fiat account endpoints. 9 endpoints available.

🎯 Quick Stats

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

📊 Methods

🔍 GET: 7 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`	`/wallet/chain-type/{token}`	Get chain type
🔍 `GET`	`/wallet/address`	Get wallet address
📝 `POST`	`/wallet/address/generate`	Generate a new wallet address
🔍 `GET`	`/wallet/account/crypto`	Get wallet crypto account
🔍 `GET`	`/wallet/account/fiat`	Get wallet fiat account
🔍 `GET`	`/wallet/accounts`	Get all user accounts (crypto and fiat)
🔍 `GET`	`/wallet/exchange-rates`	Get exchange rates
✏️ `PUT`	`/wallet/exchange-rates`	No description
🔍 `GET`	`/wallet/account/system`	Get wallet accounts for system

📖 Detailed Documentation

Get chain type

GET/wallet/chain-type/{token}

Full URL

https://api.market.decenctype.com/wallet/chain-type/{token}

🎯 Path Parameters

token (string) - ✅ Required: No description

Description: Get chain type

Operation ID: getChainType

Response Status:

✅ 200: The found chain type

📝 Example Request

curl -X GET "https://api.market.decenctype.com/wallet/chain-type/example-token" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Get wallet address

GET/wallet/address

Full URL

https://api.market.decenctype.com/wallet/address

📋 Query Parameters

Parameter	Type	Required	Description
`type`	`string`	✅	地址类型，用户地址或商户地址
`chainType`	`string`	✅	链类型
`ignoreStatus`	`boolean`	❌	是否忽略地址状态

Description: Get wallet address

Operation ID: getAddress

Response Status:

✅ 200: The found record

📋 Response Examples

response.json

1[
2  {
3    "chainAddressId": "c0a80121-7ac0-4e1c-9d67-a6b5e7b7c8d9",
4    "chainAddress": "0x1234567890abcdef1234567890abcdef12345678",
5    "chainType": "ETH",
6    "type": "user",
7    "userId": "c0a80121-7ac0-4e1c-9d67-a6b5e7b7c8d9",
8    "merchantId": "c0a80121-7ac0-4e1c-9d67-a6b5e7b7c8d9",
9    "status": "active"
10  }
11]

📝 Example Request

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

Generate a new wallet address

POST/wallet/address/generate

Full URL

https://api.market.decenctype.com/wallet/address/generate

📝 Request Body Parameters

Parameter	Type	Required	Description
`chainType`	`string`	✅	Chain Type
`chainId`	`string`	✅	Chain ID
`alias`	`string`	❌	Alias of the address
`merchantId`	`string`	❌	Merchant ID

Description: Generate a new wallet address

Operation ID: generateAddress

Response Status:

✅ 201: Success

Merchant ID is only required for merchant type

📋 Response Examples

response.json

1{
2  "chainAddressId": "c0a80121-7ac0-4e1c-9d67-a6b5e7b7c8d9",
3  "chainAddress": "0x1234567890abcdef1234567890abcdef12345678",
4  "chainType": "ETH",
5  "type": "user",
6  "userId": "c0a80121-7ac0-4e1c-9d67-a6b5e7b7c8d9",
7  "merchantId": "c0a80121-7ac0-4e1c-9d67-a6b5e7b7c8d9",
8  "status": "active"
9}

📝 Example Request

curl -X POST "https://api.market.decenctype.com/wallet/address/generate" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json" \\
  -d '{
  "chainType": "example-chainType",
  "chainId": "example-id"
}'

Get wallet crypto account

GET/wallet/account/crypto

Full URL

https://api.market.decenctype.com/wallet/account/crypto

📋 Query Parameters

Parameter	Type	Required	Description
`accountType`	`string`	✅	Type of account (示例: `user`)
`token`	`string`	✅	Cryptocurrency token type (示例: `USDT`)

Description: Get wallet crypto account

Operation ID: getCryptoAccount

Response Status:

✅ 200: The found crypto account record

📋 Response Examples

response.json

1{
2  "accountBalance": 1,
3  "accountBalanceFrozen": 1,
4  "accountToken": {},
5  "accountId": "example-id",
6  "userId": "example-id",
7  "merchantId": "example-id",
8  "accountType": {},
9  "accountStatus": {}
10}

📝 Example Request

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

Get wallet fiat account

GET/wallet/account/fiat

Full URL

https://api.market.decenctype.com/wallet/account/fiat

📋 Query Parameters

Parameter	Type	Required	Description
`accountType`	`string`	✅	Type of account (示例: `user`)
`currency`	`string`	✅	Fiat currency type (示例: `USD`)

Description: Get wallet fiat account

Operation ID: getFiatAccount

Response Status:

✅ 200: The found fiat account record

📋 Response Examples

response.json

1{
2  "accountBalance": 1,
3  "accountBalanceFrozen": 1,
4  "accountCurrency": {},
5  "accountId": "example-id",
6  "userId": "example-id",
7  "merchantId": "example-id",
8  "accountType": {},
9  "accountStatus": {}
10}

📝 Example Request

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

Get all user accounts (crypto and fiat)

GET/wallet/accounts

Full URL

https://api.market.decenctype.com/wallet/accounts

📋 Query Parameters

Parameter	Type	Required	Description
`ignoreStatus`	`boolean`	❌	Whether to ignore account status

Description: Get all user accounts (crypto and fiat)

Operation ID: getAllUserAccounts

Response Status:

✅ 200: All user accounts retrieved successfully

📋 Response Examples

response.json

1{
2  "fiatAccounts": [
3    {
4      "accountBalance": 1,
5      "accountBalanceFrozen": 1,
6      "accountCurrency": {},
7      "accountId": "example-id",
8      "userId": "example-id",
9      "merchantId": "example-id",
10      "accountType": {},
11      "accountStatus": {}
12    }
13  ],
14  "cryptoAccounts": [
15    {
16      "accountBalance": 1,
17      "accountBalanceFrozen": 1,
18      "accountToken": {},
19      "accountId": "example-id",
20      "userId": "example-id",
21      "merchantId": "example-id",
22      "accountType": {},
23      "accountStatus": {}
24    }
25  ]
26}

📝 Example Request

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

Get exchange rates

GET/wallet/exchange-rates

Full URL

https://api.market.decenctype.com/wallet/exchange-rates

📋 Query Parameters

Parameter	Type	Required	Description
`from`	`string`	✅	基础货币类型 (示例: `USDT,USDC,BTC,ETH`)
`to`	`string`	✅	目标货币类型，多个以逗号分隔 (示例: `USD,EUR`)

Description: Get exchange rates

Operation ID: getExchangeRates

Response Status:

✅ 200: The found exchange rates

📋 Response Examples

response.json

1[
2  {
3    "rateId": 1,
4    "fromCurrency": "example-fromCurrency",
5    "toCurrency": "example-toCurrency",
6    "exchangeRate": 1
7  }
8]

📝 Example Request

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

PUT /wallet/exchange-rates

PUT/wallet/exchange-rates

Full URL

https://api.market.decenctype.com/wallet/exchange-rates

🔐 Authentication: Required (see authentication section above)

Operation ID: updateExchangeRates

Response Status:

✅ 200: Success

📝 Example Request

curl -X PUT "https://api.market.decenctype.com/wallet/exchange-rates" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Get wallet accounts for system

GET/wallet/account/system

Full URL

https://api.market.decenctype.com/wallet/account/system

🔐 Authentication: Required (see authentication section above)

Description: Get wallet accounts for system

Operation ID: getSystemAccount

Response Status:

✅ 200: The found system account record

This endpoint is used to get the system account information, and can only be invoked by admin.

📋 Response Examples

response.json

1{
2  "cryptoAccounts": [
3    {
4      "accountBalance": 1,
5      "accountBalanceFrozen": 1,
6      "accountToken": {},
7      "accountId": "example-id",
8      "userId": "example-id",
9      "merchantId": "example-id",
10      "accountType": {},
11      "accountStatus": {}
12    }
13  ],
14  "fiatAccounts": [
15    {
16      "accountBalance": 1,
17      "accountBalanceFrozen": 1,
18      "accountCurrency": {},
19      "accountId": "example-id",
20      "userId": "example-id",
21      "merchantId": "example-id",
22      "accountType": {},
23      "accountStatus": {}
24    }
25  ]
26}

📝 Example Request

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

💳 Wallet Management

🎯 Quick Stats

📊 Methods

🔑 Bearer Token (Recommended)

🔧 API Key

On this page