### Enable Connect To Wallet API Request Body Example

Source: https://developers.wallex.ir/_spec/trade-credit/trade-credit_download=

This JSON snippet shows an example of the request body required for the 'Enable Connect To Wallet' endpoint. It specifies the credit, currency, and usage count for connecting a wallet.

```json
{
  "credit": "10000",
  "currency": "USDT",
  "usageCount": 3
}
```

--------------------------------

### Subscribe to All Market Prices (Go)

Source: https://developers.wallex.ir/socket/allprice

Connects to the Wallex WebSocket API using the `gorilla/websocket` library and subscribes to the 'all@price' channel. It then enters a loop to continuously read and print messages from the server. Requires the `gorilla/websocket` library to be installed (`go get github.com/gorilla/websocket`).

```go
package main

import (
    "fmt"
    "log"
    "encoding/json"
    "github.com/gorilla/websocket"
)

func main() {
    c, _, err := websocket.DefaultDialer.Dial("wss://api.wallex.ir/ws", nil)
    if err != nil {
        log.Fatal("dial:", err)
    }
    defer c.Close()

    sub := []interface{}{"subscribe", map[string]string{"channel": "all@price"}}
    msg, _ := json.Marshal(sub)
    c.WriteMessage(websocket.TextMessage, msg)

    for {
        _, message, err := c.ReadMessage()
        if err != nil {
            log.Println("read:", err)
            return
        }
        fmt.Println("Received:", string(message))
    }
}
```

--------------------------------

### Get Account Fees - API Example

Source: https://developers.wallex.ir/_spec/basicServices/basicServices_download=

Fetches the maker and taker fee rates for each market, along with recent trading volume sums. This API requires an API Key in the header for authentication. The response details fee structures per trading pair.

```json
{
  "success": true,
  "message": "عملیات با موفقیت انجام شد",
  "result": {
    "BTCTMN": {
      "makerFeeRate": "0.00200000",
      "takerFeeRate": "0.00200000",
      "recent_days_sum": 250000000
    },
    "BTCUSDT": {
      "makerFeeRate": "0.00200000",
      "takerFeeRate": "0.00200000",
      "recent_days_sum": 0
    }
  }
}
```

--------------------------------

### Credit Package Data Example (YAML)

Source: https://developers.wallex.ir/_spec/trade-credit/trade-credit_download=

This snippet shows another example of a credit package configuration. It details the 'assurance' level, 'currency' (TMN), various fee structures, 'loan' amount, and 'status'. The 'title' field is in Persian, indicating the currency and amount. Image URLs for different display modes are also provided.

```yaml
- assurance: '1000000'
  currency: TMN
  daily_fee: '10000'
  daily_fee_after_discount: '10000'
  daily_fee_discount: '0'
  dark_image_url: >-
    https://s3.thr1.sotoon.ir/wallex-public/packages/1rX2EiHtSN0pm8wY5IeeD0PVFfPV8YtARYhS5K1u.png
  destination_currency: null
  expire_days: 30
  final_fee: '300000'
  final_fee_after_discount: '300000'
  final_fee_discount: '0'
  id: 101
  light_image_url: >-
    https://s3.thr1.sotoon.ir/wallex-public/packages/4cyZKkkKacBAEOMYrBqCmKdTlL4RWey1anAEjwQk.png
  liquidity_limit: '10400000'
  loan: '10000000'
  status: ACTIVE
  title: 10 میلیون اعتبار معاملاتی
  warning_limit: '10700000'
```

--------------------------------

### GET /websites/developers_wallex_ir

Source: https://developers.wallex.ir/_spec/trade-credit/trade-credit_download=

Retrieves a list of available trading credit packages with their detailed specifications.

```APIDOC
## GET /websites/developers_wallex_ir

### Description
Retrieves a list of available trading credit packages. Each package includes details such as loan amount, fees, limits, and status.

### Method
GET

### Endpoint
/websites/developers_wallex_ir

### Parameters
This endpoint does not accept any path or query parameters.

### Request Body
This endpoint does not accept a request body.

### Request Example
```json
GET /websites/developers_wallex_ir
```

### Response
#### Success Response (200)
Returns a JSON array of package objects. Each object contains:
- **assurance** (string): The assurance amount for the package.
- **currency** (string): The currency of the package (e.g., 'TMN').
- **daily_fee** (string): The daily fee for the package.
- **daily_fee_after_discount** (string): The daily fee after any applicable discounts.
- **daily_fee_discount** (string): The amount of discount on the daily fee.
- **dark_image_url** (string): URL for the dark theme package image.
- **destination_currency** (string | null): The destination currency, if applicable.
- **expire_days** (integer): The number of days the package is valid.
- **final_fee** (string): The final fee for the package.
- **final_fee_after_discount** (string): The final fee after any applicable discounts.
- **final_fee_discount** (string): The amount of discount on the final fee.
- **id** (integer): The unique identifier for the package.
- **light_image_url** (string): URL for the light theme package image.
- **liquidity_limit** (string): The liquidity limit for the package.
- **loan** (string): The loan amount offered by the package.
- **status** (string): The status of the package (e.g., 'ACTIVE', 'INACTIVE').
- **title** (string): The title of the package.
- **warning_limit** (string): The warning limit for the package.

#### Response Example
```json
[
  {
    "assurance": "150000000",
    "currency": "TMN",
    "daily_fee": "100000",
    "daily_fee_after_discount": "100000",
    "daily_fee_discount": "0",
    "dark_image_url": "https://s3.thr1.sotoon.ir/wallex-public/packages/KOi8SROWgHh4UDRD3p4VHdPlaBJRVgjic6ry94Yb.png",
    "destination_currency": null,
    "expire_days": 30,
    "final_fee": "1500000",
    "final_fee_after_discount": "1500000",
    "final_fee_discount": "0",
    "id": 79,
    "light_image_url": "https://s3.thr1.sotoon.ir/wallex-public/packages/PUqIeYEOLP9WOLTZCIxpU4bL5NRF6lwDDnwd7tCE.png",
    "liquidity_limit": "52000000",
    "loan": "50000000",
    "status": "ACTIVE",
    "title": "50 میلیون اعتبار معاملاتی",
    "warning_limit": "53500000"
  },
  {
    "assurance": "20000000",
    "currency": "TMN",
    "daily_fee": "100000",
    "daily_fee_after_discount": "100000",
    "daily_fee_discount": "0",
    "dark_image_url": "https://s3.thr1.sotoon.ir/wallex-public/packages/KOi8SROWgHh4UDRD3p4VHdPlaBJRVgjic6ry94Yb.png",
    "destination_currency": null,
    "expire_days": 30,
    "final_fee": "3000000",
    "final_fee_after_discount": "3000000",
    "final_fee_discount": "0",
    "id": 104,
    "light_image_url": "https://s3.thr1.sotoon.ir/wallex-public/packages/9Hu9vt5HFlUxNKxKLmd6oqeAoiiMtqIWb9MCiRom.png",
    "liquidity_limit": "104000000",
    "loan": "100000000",
    "status": "ACTIVE",
    "title": "100 میلیون اعتبار معاملاتی",
    "warning_limit": "107000000"
  }
]
```
```

--------------------------------

### Spot Trading with Trading Credit Account Header Example

Source: https://developers.wallex.ir/spot

This code snippet shows an example of the 'sub-account-client-id' to be included in the Request-Header when performing spot trades using a trading credit account. Ensure you replace 'YOUR subAccount-ClientId' with your actual client ID.

```json
{
  "sub-account-client-id" : "YOUR subAccount-ClientId"
}
```

--------------------------------

### GET /websites/developers_wallex_ir

Source: https://developers.wallex.ir/_spec/trade-credit/trade-credit_download=

Retrieves a list of developer configurations or projects associated with the Wallex IR website.

```APIDOC
## GET /websites/developers_wallex_ir

### Description
Retrieves a list of developer configurations or projects associated with the Wallex IR website. This endpoint provides details about various developer projects, their status, and associated media.

### Method
GET

### Endpoint
/websites/developers_wallex_ir

### Parameters
#### Query Parameters
- **type** (string) - Optional - Filters results by project type.
- **isActive** (boolean) - Optional - Filters results by active status.

### Request Example
```json
{
  "example": ""
}
```

### Response
#### Success Response (200)
- **clientId** (string) - Unique identifier for the client.
- **createdAt** (string) - Timestamp when the record was created.
- **darkAvatarUrl** (string) - URL for the dark mode avatar.
- **isActive** (boolean) - Indicates if the project is currently active.
- **isSuspend** (boolean) - Indicates if the project is suspended.
- **lightAvatarUrl** (string) - URL for the light mode avatar.
- **title** (string) - The title or name of the project.
- **type** (string) - The type of the developer project (e.g., 'prop', 'trading_bot_trade').
- **userId** (number) - The user ID associated with the project.

#### Response Example
```json
{
  "example": [
    {
      "clientId": "CLIENTID",
      "createdAt": "2025-04-06T11:53:18Z",
      "darkAvatarUrl": "https://s3.thr1.sotoon.ir/phinix-public-staging/packages/clHyoeip3vrFmJvxRbjMP42h8PYDSWcKeo0zkQZO.jpg",
      "isActive": true,
      "isSuspend": false,
      "lightAvatarUrl": "https://s3.thr1.sotoon.ir/phinix-public-staging/packages/clHyoeip3vrFmJvxRbjMP42h8PYDSWcKeo0zkQZO.jpg",
      "title": "تست اولیه عادی",
      "type": "prop",
      "userId": 0
    },
    {
      "clientId": "CLIENTID",
      "createdAt": "2024-11-19T09:20:37Z",
      "darkAvatarUrl": "https://s3.thr1.sotoon.ir/phinix-public-staging/packages/clHyoeip3vrFmJvxRbjMP42h8PYDSWcKeo0zkQZO.jpg",
      "isActive": true,
      "isSuspend": false,
      "lightAvatarUrl": "https://s3.thr1.sotoon.ir/phinix-public-staging/packages/clHyoeip3vrFmJvxRbjMP42h8PYDSWcKeo0zkQZO.jpg",
      "title": null,
      "type": "trading_bot_trade",
      "userId": 0
    }
  ]
}
```
```

--------------------------------

### Get Account Card Numbers - API Example

Source: https://developers.wallex.ir/_spec/basicServices/basicServices_download=

Retrieves a list of the user's bank cards associated with their account. Requires an API Key in the header for authentication. Returns card details including status, owner, and bank.

```json
{
  "result": [
    {
      "id": "شناسه یکتا",
      "card_number": "6219861*******32",
      "owners": [
        "نام صاحب حساب"
      ],
      "status": "ACCEPTED",
      "is_default": 0,
      "bank_details": {
        "code": "bankCode",
        "label": "بانک سامان"
      }
    }
  ],
  "message": "The operation was successful",
  "success": true,
  "result_info": {
    "page": 1,
    "per_page": 4,
    "count": 4,
    "total_count": 4
  }
}
```

--------------------------------

### GET /websites/developers_wallex_ir

Source: https://developers.wallex.ir/basicservices/accountfee

Fetches the user level and fee details for the authenticated account.

```APIDOC
## GET /websites/developers_wallex_ir

### Description
Retrieves the current user level and trading fees (maker and taker) for your account, along with recent trading volume.

### Method
GET

### Endpoint
/websites/developers_wallex_ir

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **result** (object) - Contains fee details for different trading pairs.
  - **[SYMBOL]** (object) - Details for a specific trading pair.
    - **makerFeeRate** (string) - The maker fee rate.
    - **takerFeeRate** (string) - The taker fee rate.
    - **recent_days_sum** (string) - The sum of trading volume over recent days.

#### Response Example
```json
{
  "result": {
    "SHIBTMN": {
      "makerFeeRate": "0.0005",
      "takerFeeRate": "0.0007",
      "recent_days_sum": "12345.67"
    }
  }
}
```
```

--------------------------------

### Enable Connect To Wallet API Response Example

Source: https://developers.wallex.ir/_spec/trade-credit/trade-credit_download=

This JSON snippet demonstrates a successful response from the 'Enable Connect To Wallet' endpoint. It includes details about the wallet connection status, credit, usage counts, and a success message.

```json
{
    "result": {
        "currency": "USDT",
        "credit": "10000",
        "usageCount": 3,
        "usedCount": 0,
        "status": "active"
    },
    "message": "اتصال کیف پول با موفقیت انجام شد",
    "success": true
}
```

--------------------------------

### GET /websites/developers_wallex_ir

Source: https://developers.wallex.ir/_spec/trade-credit/trade-credit_download=

Retrieves a list of available trading credit packages for the specified project. This endpoint returns details such as daily fees, loan amounts, and image URLs for each package.

```APIDOC
## GET /websites/developers_wallex_ir

### Description
Retrieves a list of available trading credit packages for the specified project. This endpoint returns details such as daily fees, loan amounts, and image URLs for each package.

### Method
GET

### Endpoint
/websites/developers_wallex_ir

### Parameters
#### Query Parameters
* **project** (string) - Required - The identifier for the project (e.g., 'developers_wallex_ir').

### Request Example
```
GET /websites/developers_wallex_ir?project=developers_wallex_ir
```

### Response
#### Success Response (200)
- **message** (string) - A success message indicating the operation was completed.
- **result** (array) - An array of package objects, each containing:
  - **assurance** (string) - The assurance amount for the package.
  - **currency** (string) - The currency of the package (e.g., 'TMN').
  - **daily_fee** (string) - The daily fee for the package.
  - **daily_fee_after_discount** (string) - The daily fee after any applicable discounts.
  - **daily_fee_discount** (string) - The amount of daily fee discount.
  - **dark_image_url** (string) - The URL for the dark theme package image.
  - **destination_currency** (null) - Currently null, may be used in future updates.
  - **expire_days** (integer) - The number of days until the package expires.
  - **final_fee** (string) - The final fee for the package.
  - **final_fee_after_discount** (string) - The final fee after any applicable discounts.
  - **final_fee_discount** (string) - The amount of final fee discount.
  - **id** (integer) - The unique identifier for the package.
  - **light_image_url** (string) - The URL for the light theme package image.
  - **liquidity_limit** (string) - The liquidity limit associated with the package.
  - **loan** (string) - The loan amount provided by the package.
  - **status** (string) - The status of the package (e.g., 'ACTIVE', 'INACTIVE').
  - **title** (string) - The title of the package.
  - **warning_limit** (string) - The warning limit for the package.

#### Response Example
```json
{
  "message": "عملیات با موفقیت انجام شد",
  "result": [
    {
      "assurance": "60000000",
      "currency": "TMN",
      "daily_fee": "600000",
      "daily_fee_after_discount": "600000",
      "daily_fee_discount": "0",
      "dark_image_url": "https://s3.thr1.sotoon.ir/wallex-public/packages/QrOWJudTqCA4BxKlRZ99vFcnkUG5SEWNBoK5ayu2.png",
      "destination_currency": null,
      "expire_days": 30,
      "final_fee": "18000000",
      "final_fee_after_discount": "18000000",
      "final_fee_discount": "0",
      "id": 147,
      "light_image_url": "https://s3.thr1.sotoon.ir/wallex-public/packages/ceY4TTn6yQXvmUHZvy2g3e5B8zt6sGsI2XAQuhFl.png",
      "liquidity_limit": "624000000",
      "loan": "600000000",
      "status": "INACTIVE",
      "title": "600 میلیون اعتبار معاملاتی",
      "warning_limit": "642000000"
    }
  ]
}
```
```

--------------------------------

### Subscribe to All Market Prices (Python)

Source: https://developers.wallex.ir/socket/allprice

Utilizes the `websocket-client` library to connect to the Wallex WebSocket API and subscribe to the 'all@price' channel. Received messages are printed to the console. Requires the `websocket-client` library to be installed (`pip install websocket-client`).

```python
import websocket
import json

def on_message(ws, message):
    print("Received:", message)

def on_open(ws):
    subscribe = ["subscribe", { "channel": "all@price" }]
    ws.send(json.dumps(subscribe))

ws = websocket.WebSocketApp(
    "wss://api.wallex.ir/ws",
    on_open=on_open,
    on_message=on_message
)

ws.run_forever()
```

--------------------------------

### Example JSON Response for User Package History

Source: https://developers.wallex.ir/_spec/trade-credit/trade-credit_download=

This JSON object represents a successful response for the userPackageHistoryDetails operation. It includes details about the user's package, such as balances, fees, dates, and status. The 'result' object contains the core package data, while 'message' and 'success' indicate the operational outcome.

```json
{
    "result": {
        "user_id": "testUserId",
        "client_id": "testClientId",
        "package_title": "طرح ۱۰",
        "dark_image_url": "https://s3.thr1.sotoon.ir/phinix-public-staging/packages/clHyoeip3vrFmJvxRbjMP42h8PYDSWcKeo0zkQZO.jpg",
        "light_image_url": "https://s3.thr1.sotoon.ir/phinix-public-staging/packages/clHyoeip3vrFmJvxRbjMP42h8PYDSWcKeo0zkQZO.jpg",
        "currency": "USDT",
        "destination_currency": "USDT",
        "assurance": "300",
        "loan": "1000",
        "final_balance": "1298.62",
        "final_balance_without_transfers": "1298.62",
        "start_balance": "1300",
        "warning_limit": "1001",
        "liquidity_limit": "1081",
        "created_at": "2025-02-08T08:47:00.000000Z",
        "finished_at": "2025-02-08T09:05:49.000000Z",
        "expire_at": "2025-03-10T08:47:00.000000Z",
        "close_reason": "بستن طرح",
        "status": "SUSPEND",
        "expire_days": 30,
        "daily_fee": "1",
        "daily_fee_discount": "0",
        "daily_fee_after_discount": "1",
        "final_fee": "30",
        "final_fee_discount": "0",
        "final_fee_after_discount": "30",
        "open_days": 1,
        "total_days": 1,
        "applicable_daily_fee": "1",
        "applicable_daily_fee_discount": "0",
        "applicable_daily_fee_after_discount": "1",
        "profit": "-2.38",
        "profit_percentage": "-0.18",
        "final_assurance": "297.62",
        "final_payBack": "1001"
    },
    "message": "عملیات با موفقیت انجام شد",
    "success": true
}
```

--------------------------------

### GET /websites/developers_wallex_ir/api/getOtcPrice

Source: https://developers.wallex.ir/otc/otcprice

Retrieves real-time prices for a given trading symbol and trade side from the instant trading market.

```APIDOC
## GET /websites/developers_wallex_ir/api/getOtcPrice

### Description
Retrieves real-time prices for a given trading symbol and trade side from the instant trading market.

### Method
GET

### Endpoint
/websites/developers_wallex_ir/api/getOtcPrice

### Parameters
#### Query Parameters
- **side** (string) - Required - To determine the side of your order, sending this value is mandatory. Valid Values: "BUY" | "SELL"
- **symbol** (string) - Required - To get the price, you must send the market name.

### Request Example
```json
{
  "example": "GET /websites/developers_wallex_ir/api/getOtcPrice?symbol=BTCUSDT&side=BUY"
}
```

### Response
#### Success Response (200)
- **result** (object) - Contains price details.
  - **price** (string) - The current price.
  - **price_expires_at** (string) - The expiration time of the price.
  - **ttl** (string) - Time to live for the price.
  - **current_time** (string) - The current server time.
- **message** (string) - A success message.
- **success** (boolean) - Indicates if the operation was successful.

#### Response Example
```json
{
  "result": {
    "price": "65000.00",
    "price_expires_at": "2024-07-26T10:00:00Z",
    "ttl": "60",
    "current_time": "2024-07-26T09:59:00Z"
  },
  "message": "عملیات با موفقیت انجام شد",
  "success": true
}
```
```

--------------------------------

### Get User Packages

Source: https://developers.wallex.ir/_spec/trade-credit/trade-credit_download=

Retrieves a list of user packages along with their aggregated details, balances history, and package specifics.

```APIDOC
## GET /websites/developers_wallex_ir/user-packages

### Description
Retrieves detailed information about a user's packages, including financial summaries and historical balance data.

### Method
GET

### Endpoint
/websites/developers_wallex_ir/user-packages

### Parameters
#### Query Parameters
* **userId** (string) - Required - The unique identifier of the user.

### Request Example
```json
{
  "userId": "user123"
}
```

### Response
#### Success Response (200)
- **message** (string) - Confirmation message of the operation.
- **result** (object) - Contains the aggregated details and user package information.
  - **aggregatedDetail** (object) - Summary of package finances.
    - **assurance** (string) - Assurance amount for the package.
    - **currency** (string) - Currency of the package (e.g., TMN).
    - **loan** (string) - Loan amount associated with the package.
    - **profit** (string) - Calculated profit for the package.
    - **profitPercentage** (string) - Percentage of profit for the package.
  - **userPackages** (array) - An array of user package objects.
    - **balancesHistory** (object) - Historical balance data.
      - **perDay** (object) - Balances for specific dates.
        - **'YYYY-MM-DD'** (object) - Balances for a given day, with currency keys (e.g., BTC, TMN, USDT).
      - **total** (object) - Total balances across all currencies.
    - **packageDetail** (object) - Details of the specific package.
      - **assurance** (string) - Assurance amount.
      - **currency** (string) - Package currency.
      - **darkImageUrl** (string) - URL for the dark theme package image.
      - **expireDays** (number) - Number of days the package is valid.
      - **lightImageUrl** (string) - URL for the light theme package image.
      - **loan** (string) - Loan amount.
      - **title** (string) - Name or title of the package.
    - **userPackageDetail** (object) - User-specific details for the package.
      - **createdAt** (string) - Timestamp when the user's package was created.
      - **expireAt** (string) - Timestamp when the user's package expires.
      - **id** (number) - Unique identifier for the user's package.
      - **profit** (string) - User's profit for this package.
      - **profitPercentage** (string) - User's profit percentage for this package.
      - **status** (string) - Current status of the user's package (e.g., 'liquid').
      - **subAccountClientId** (string) - Client ID associated with the sub-account.

#### Response Example
```json
{
  "message": "عملیات با موفقیت انجام شد",
  "result": {
    "aggregatedDetail": {
      "assurance": "1000000",
      "currency": "TMN",
      "loan": "200000000",
      "profit": "-1999995000",
      "profitPercentage": "-995.02"
    },
    "userPackages": [
      {
        "balancesHistory": {
          "perDay": {
            "2025-04-06": {
              "BTC": 0.023551144650712032,
              "TMN": 201000000,
              "USDT": 1939.087567651003
            }
          },
          "total": {
            "BTC": 0.023551144650712032,
            "TMN": 201000000,
            "USDT": 1939.087567651003
          }
        },
        "packageDetail": {
          "assurance": "1000000",
          "currency": "TMN",
          "darkImageUrl": "https://s3.thr1.sotoon.ir/phinix-public-staging/packages/clHyoeip3vrFmJvxRbjMP42h8PYDSWcKeo0zkQZO.jpg",
          "expireDays": 30,
          "lightImageUrl": "https://s3.thr1.sotoon.ir/phinix-public-staging/packages/clHyoeip3vrFmJvxRbjMP42h8PYDSWcKeo0zkQZO.jpg",
          "loan": "200000000",
          "title": "طرح ۵"
        },
        "userPackageDetail": {
          "createdAt": "2025-04-06T11:50:11.000000Z",
          "expireAt": "2025-05-06T11:50:11.000000Z",
          "id": 339,
          "profit": "-1999995000",
          "profitPercentage": "-995.02",
          "status": "liquid",
          "subAccountClientId": "CLIENTID"
        }
      }
    ]
  }
}
```
```

--------------------------------

### Get Website Packages

Source: https://developers.wallex.ir/_spec/trade-credit/trade-credit_download=

Retrieves a list of available packages for a specific website, including details like fees, image URLs, and liquidity limits.

```APIDOC
## GET /websites/developers_wallex_ir/packages

### Description
Retrieves a list of available packages for the specified website.

### Method
GET

### Endpoint
/websites/developers_wallex_ir/packages

### Parameters

#### Query Parameters

#### Request Body

### Request Example
```json
{
  "message": "GET request to retrieve website packages"
}
```

### Response
#### Success Response (200)
- **packages** (array) - A list of package objects.
  - **id** (integer) - Unique identifier for the package.
  - **title** (string) - The title of the package (e.g., '1000 تتر اعتبار معاملاتی').
  - **loan** (string) - The loan amount associated with the package.
  - **assurance** (string) - The assurance amount for the package.
  - **currency** (string) - The currency of the package (e.g., 'USDT', 'TMN').
  - **daily_fee** (string) - The daily fee for the package.
  - **daily_fee_after_discount** (string) - The daily fee after discount.
  - **daily_fee_discount** (string) - The daily fee discount.
  - **final_fee** (string) - The final fee for the package.
  - **final_fee_after_discount** (string) - The final fee after discount.
  - **final_fee_discount** (string) - The final fee discount.
  - **expire_days** (integer) - The number of days until the package expires.
  - **liquidity_limit** (string) - The liquidity limit for the package.
  - **warning_limit** (string) - The warning limit for the package.
  - **status** (string) - The status of the package (e.g., 'ACTIVE').
  - **light_image_url** (string) - URL for the light theme image.
  - **dark_image_url** (string) - URL for the dark theme image.
  - **destination_currency** (null) - Placeholder for destination currency, currently null.

#### Response Example
```json
{
  "packages": [
    {
      "id": 146,
      "title": "1000 تتر اعتبار معاملاتی",
      "loan": "1000",
      "assurance": "0.5",
      "currency": "USDT",
      "daily_fee": "0.5",
      "daily_fee_after_discount": "0.5",
      "daily_fee_discount": "0",
      "final_fee": "15",
      "final_fee_after_discount": "15",
      "final_fee_discount": "0",
      "expire_days": 30,
      "liquidity_limit": "1040",
      "warning_limit": "1070",
      "status": "ACTIVE",
      "light_image_url": "https://s3.thr1.sotoon.ir/wallex-public/packages/S81UZpQ9QsWjnxW47rrVww1tiwor18nwG2j6NXb6.png",
      "dark_image_url": "https://s3.thr1.sotoon.ir/wallex-public/packages/cCM6nyg1K9akqVnIGQVZ3elO9xd1eG55qexYlCgf.png",
      "destination_currency": null
    }
  ]
}
```
```

--------------------------------

### Get Active User Package Details

Source: https://developers.wallex.ir/_spec/trade-credit/trade-credit_download=

Fetches the details of the currently active user package. Requires a sub-account client ID in the header for authentication.

```APIDOC
## GET /websites/developers_wallex_ir/activeUserPackageDetails

### Description
Retrieves detailed information about a user's active package, including financial metrics, alerts, and balance history.

### Method
GET

### Endpoint
/websites/developers_wallex_ir/activeUserPackageDetails

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **message** (string) - A confirmation message indicating the operation was successful.
- **result** (object) - An object containing the detailed results of the active user package.
  - **alertsData** (array) - A list of alerts associated with the user's package.
    - **type** (string) - The type of alert (e.g., "public_warning_low_credit").
  - **balancesHistory** (object) - Historical balance data.
    - **perDay** (object) - Balance data broken down by day.
      - **[date]** (object) - An object where the key is the date (YYYY-MM-DD) and the value contains balance details for that day.
        - **BTC** (number) - Balance of Bitcoin.
        - **TMN** (number) - Balance of TMN.
        - **USDT** (number) - Balance of USDT.
    - **total** (object) - Total balance across all currencies.
      - **BTC** (number) - Total balance of Bitcoin.
      - **TMN** (number) - Total balance of TMN.
      - **USDT** (number) - Total balance of USDT.

#### Response Example
```json
{
    "message": "عملیات با موفقیت انجام شد",
    "success": true,
    "result": {
        "alertsData": [
            {
                "type": "public_warning_low_credit"
            }
        ],
        "balancesHistory": {
            "total": {
                "TMN": 201000000,
                "USDT": 1939.087567651003,
                "BTC": 0.023551144650712032
            },
            "perDay": {
                "2025-04-06": {
                    "TMN": 201000000,
                    "USDT": 1939.087567651003,
                    "BTC": 0.023551144650712032
                }
            }
        }
    }
}
```
```

--------------------------------

### GET /websites/developers_wallex_ir

Source: https://developers.wallex.ir/_spec/trade-credit/trade-credit_download=

Retrieves a list of user package history entries. This endpoint provides detailed information about past packages, including financial data, status, and dates.

```APIDOC
## GET /websites/developers_wallex_ir

### Description
Retrieves a list of user package history entries. This endpoint provides detailed information about past packages, including financial data, status, and dates.

### Method
GET

### Endpoint
/websites/developers_wallex_ir

### Parameters
#### Query Parameters
- **page** (number) - Optional - The page number for pagination.
- **per_page** (number) - Optional - The number of items per page for pagination.

### Request Example
(No request body for GET request)

### Response
#### Success Response (200)
- **result** (array) - A list of package history objects.
  - **unique_id** (number) - Unique identifier for the package.
  - **source_client_id** (string) - ID of the source client.
  - **source_client_title** (string) - Title of the source client.
  - **destination_client_id** (string) - ID of the destination client.
  - **destination_client_title** (string) - Title of the destination client.
  - **source_user_type** (string) - User type of the source.
  - **destination_user_type** (string) - User type of the destination.
  - **fa_source_user_type** (string) - FA source user type.
  - **fa_destination_user_type** (string) - FA destination user type.
  - **currency** (string) - Currency of the package.
  - **value** (string) - Value of the package.
  - **reason** (string) - Reason for the package entry.
  - **createdAt** (string) - Creation timestamp of the package entry.
  - **final_balance_without_transfers** (string) - Final balance without transfers.
  - **start_balance** (string) - Starting balance.
  - **warning_limit** (string) - Warning limit for the package.
  - **liquidity_limit** (string) - Liquidity limit for the package.
  - **created_at** (string) - Creation date of the package.
  - **finished_at** (string) - Finish date of the package.
  - **expire_at** (string) - Expiration date of the package.
  - **close_reason** (string) - Reason for closing the package.
  - **status** (string) - Status of the package.
  - **expire_days** (number) - Number of days until expiration.
  - **daily_fee** (string) - Daily fee amount.
  - **daily_fee_discount** (string) - Daily fee discount amount.
  - **daily_fee_after_discount** (string) - Daily fee after discount.
  - **final_fee** (string) - Final fee amount.
  - **final_fee_discount** (string) - Final fee discount amount.
  - **final_fee_after_discount** (string) - Final fee after discount.
  - **open_days** (number) - Number of open days.
  - **total_days** (number) - Total number of days.
  - **applicable_daily_fee** (string) - Applicable daily fee.
  - **applicable_daily_fee_discount** (string) - Applicable daily fee discount.
  - **applicable_daily_fee_after_discount** (string) - Applicable daily fee after discount.
  - **profit** (string) - Profit amount.
  - **profit_percentage** (string) - Profit percentage.
  - **final_assurance** (string) - Final assurance amount.
  - **final_payBack** (string) - Final pay back amount.
- **message** (string) - A message indicating the status of the operation.
- **success** (boolean) - Indicates if the operation was successful.
- **result_info** (object) - Information about the result set.
  - **page** (number) - Current page number.
  - **per_page** (number) - Number of items per page.
  - **count** (number) - Number of items on the current page.
  - **total_count** (number) - Total number of items available.

#### Response Example
```json
{
  "result": [
    {
      "unique_id": 0,
      "source_client_id": "testClientId",
      "source_client_title": "",
      "destination_client_id": "",
      "destination_client_title": null,
      "source_user_type": "",
      "destination_user_type": "",
      "fa_source_user_type": "",
      "fa_destination_user_type": "",
      "currency": "",
      "value": "",
      "reason": "",
      "createdAt": "",
      "final_balance_without_transfers": "10000000",
      "start_balance": "10000000",
      "warning_limit": "5000000",
      "liquidity_limit": "1000000",
      "created_at": "2024-03-26 05:39:04",
      "finished_at": "",
      "expire_at": "",
      "close_reason": "بستن طرح",
      "status": "active",
      "expire_days": 0,
      "daily_fee": "2600000",
      "daily_fee_discount": "0",
      "daily_fee_after_discount": "2600000",
      "final_fee": "0",
      "final_fee_discount": "0",
      "final_fee_after_discount": "0",
      "open_days": 10,
      "total_days": 30,
      "applicable_daily_fee": "2600000",
      "applicable_daily_fee_discount": "0",
      "applicable_daily_fee_after_discount": "2600000",
      "profit": "0",
      "profit_percentage": "0",
      "final_assurance": "20000000",
      "final_payBack": "0"
    }
  ],
  "message": "عملیات با موفقیت انجام شد",
  "success": true,
  "result_info": {
    "page": 1,
    "per_page": 10,
    "count": 1,
    "total_count": 1
  }
}
```
```

--------------------------------

### GET /websites/developers_wallex_ir

Source: https://developers.wallex.ir/_spec/trade-credit/trade-credit_download=

Retrieves a list of developer websites with detailed information, including creation date, avatar URLs, activity status, and type. Supports pagination and filtering.

```APIDOC
## GET /websites/developers_wallex_ir

### Description
Retrieves a list of developer websites with detailed information, including creation date, avatar URLs, activity status, and type. Supports pagination and filtering.

### Method
GET

### Endpoint
/websites/developers_wallex_ir

### Parameters
#### Query Parameters
- **page** (integer) - Optional - The page number for pagination.
- **per_page** (integer) - Optional - The number of items per page.

### Request Example
```json
{
  "example": ""
}
```

### Response
#### Success Response (200)
- **message** (string) - Confirmation message.
- **result** (array) - An array of website objects, each containing:
  - **clientId** (string) - The client ID of the website.
  - **createdAt** (string) - The creation timestamp of the website.
  - **darkAvatarUrl** (string) - URL for the dark mode avatar.
  - **isActive** (boolean) - Indicates if the website is active.
  - **isSuspend** (boolean) - Indicates if the website is suspended.
  - **lightAvatarUrl** (string) - URL for the light mode avatar.
  - **title** (string) - The title of the website.
  - **type** (string) - The type of the website (e.g., 'trading_bot_trade', 'prop').
  - **userId** (integer) - The user ID associated with the website.
- **result_info** (object) - Pagination information:
  - **count** (number) - The number of items on the current page.
  - **page** (number) - The current page number.
  - **per_page** (number) - The number of items per page.
  - **total_count** (number) - The total number of items available.
- **success** (boolean) - Indicates if the request was successful.

#### Response Example
```json
{
  "message": "عملیات با موفقیت انجام شد",
  "result": [
    {
      "clientId": "CLIENTID",
      "createdAt": "2025-04-06T11:53:18Z",
      "darkAvatarUrl": "https://s3.thr1.sotoon.ir/phinix-public-staging/packages/clHyoeip3vrFmJvxRbjMP42h8PYDSWcKeo0zkQZO.jpg",
      "isActive": true,
      "isSuspend": false,
      "lightAvatarUrl": "https://s3.thr1.sotoon.ir/phinix-public-staging/packages/clHyoeip3vrFmJvxRbjMP42h8PYDSWcKeo0zkQZO.jpg",
      "title": "تست اولیه عادی",
      "type": "prop",
      "userId": 0
    },
    {
      "clientId": "CLIENTID",
      "createdAt": "2024-11-19T09:20:37Z",
      "darkAvatarUrl": "https://s3.thr1.sotoon.ir/phinix-public-staging/packages/clHyoeip3vrFmJvxRbjMP42h8PYDSWcKeo0zkQZO.jpg",
      "isActive": true,
      "isSuspend": false,
      "lightAvatarUrl": "https://s3.thr1.sotoon.ir/phinix-public-staging/packages/clHyoeip3vrFmJvxRbjMP42h8PYDSWcKeo0zkQZO.jpg",
      "title": null,
      "type": "trading_bot_trade",
      "userId": 0
    }
  ],
  "result_info": {
    "count": 11,
    "page": 1,
    "per_page": 11,
    "total_count": 11
  },
  "success": true
}
```
```