Search Trades

This endpoint allows you to search and list trades with pagination support.

Endpoint

GET /api/v1/trades

Headers

Name	Type	Description
Authorization	string	Bearer token for authentication
X-Target-Server	string	Target server identifier (e.g., "declaration")

Query Parameters

Name	Type	Description
page	integer	Page number for pagination (default: 1)
per_page	integer	Number of items per page (default: 10)

Response

Success Response (200 OK)

{
  "data": [
    {
      "id": "string",
      "name": "string",
      "node_name": "string",
      "node_id": "string",
      "status": "integer",
      "type": "integer",
      "permissions": [
        {
          "node_id": "string",
          "created_at": "string"
        }
      ],
      "created_by": "string",
      "created_at": "string",
      "updated_at": "string"
    }
  ],
  "total": "integer",
  "page": "integer",
  "per_page": "integer"
}

Response Fields

Field	Type	Description
data	array	Array of trade objects
data[].id	string	Unique identifier of the trade
data[].name	string	Name of the trade
data[].node_name	string	Name of the node
data[].node_id	string	ID of the node
data[].status	integer	Status of the trade
data[].type	integer	Type of the trade
data[].permissions	array	Array of permission objects
data[].permissions[].node_id	string	ID of the node with permission
data[].permissions[].created_at	string	Creation timestamp of the permission
data[].created_by	string	ID of the user who created the trade
data[].created_at	string	Creation timestamp of the trade
data[].updated_at	string	Last update timestamp of the trade
total	integer	Total number of trades
page	integer	Current page number
per_page	integer	Number of items per page

Example Request

curl --request GET \
  --url '{{HOST}}/api/v1/trades?page=1&per_page=10' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --header 'X-Target-Server: declaration'

Example Response

{
  "data": [
    {
      "id": "68247532b5e19b4fafa3f894",
      "name": "API Trade",
      "node_name": "Interzoon A.S",
      "node_id": "6784fea5481a2963fcb2d74c",
      "status": 1,
      "type": 1,
      "permissions": [],
      "created_by": "6784fea5481a2963fcb2d74d",
      "created_at": "2025-05-14T10:49:22.835Z",
      "updated_at": "2025-05-14T10:49:22.835Z"
    }
  ],
  "total": 19,
  "page": 1,
  "per_page": 10
}