User Bots

This endpoint allows you to retrieve all bots that have been created by the user

Get List of Bots

GET https://api.aitrade.com/api/bots

Query Params

Name	Type	Required	Description
page_size	integer		maximum number of items returned per request
page	integer		Current page number for pagination
sort_by	string		Sort the list by apy or wl_ratio.
sort_direction	string		Order of sorting, either desc for descending or asc for ascending
status	string		Filter the list by status, options are active or inactive

Responses:

• Success (200): Returns the list of bots created and other bots' settings.

• Failure (401): Unauthenticated, indicating you're not logged in or lack permission to carry out the request.

200 successfully returned

{
    "code": 200,
    "message": "Success",
    "bots": {
        "current_page": 1,
        "data": [
            {
                "id": 159451,
                "user_id": 825,
                "name": "New Bot",
                "status": "active",
                "frequency": 15,
                "exchange_pair_id": 2771,
                "strategy": "Long",
                "initial_fund": 100,
                "base_order_percentage": 50,
                "base_order_type": "static",
                "extra_order_percentage": 25,
                "profit": 10,
                "stop_loss": 0,
                "updated_at": "2024-03-10 14:21:28",
                "created_at": "2023-11-10 01:53:25",
                "deleted_at": null,
                "indicator_triggers_entry": 1,
                "indicator_triggers_exit": 0,
                "pair_id": 11,
                "order_type": "market",
                "bot_id": 159451,
                "deal_status": 1,
                "deal_status_name": "Deal In Progress",
                "deal_status_name_short": "IN PROGRESS",
                "apy": "10.77",
            }
        ],
        "first_page_url": "https://api.stockhero.ai/api/bots?page=1",
        "from": 1,
        "last_page": 1,
        "last_page_url": "https://api.stockhero.ai/api/bots?page=1",
        "links": [
            {
                "url": null,
                "label": "« Previous",
                "active": false
            },
            {
                "url": "https://api.stockhero.ai/api/bots?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next »",
                "active": false
            }
        ],
        "next_page_url": null,
        "path": "https://api.stockhero.ai/api/bots",
        "per_page": "10",
        "prev_page_url": null,
        "to": 1,
        "total": 1
    }
}

401 Unauthenticated

{
  "code": 401,
  "success": false,
  "message": "Unauthenticated."
}