Get Secondary Group Search

Search for secondary market groups across all tokens.

Endpoint

POST /v2/users/secondary-markets/group-search

Headers

Header	Value
Content-Type	application/json
Authorization	Bearer {token}

Request Body

{
    "page": 1,
    "per_page": 10,
    "filters": {
        "token_id": "string",
        "min_price": "number",
        "max_price": "number",
        "price_symbol": "string",
        "min_quantity": "number",
        "max_quantity": "number",
        "seller_id": "string",
        "status": "string"
    }
}

Parameters

Parameter	Type	Required	Description
page	integer	Yes	Page number for pagination
per_page	integer	Yes	Number of items per page
filters	object	No	Optional filters for search
filters.token_id	string	No	Filter by specific token ID
filters.min_price	number	No	Minimum price filter
filters.max_price	number	No	Maximum price filter
filters.price_symbol	string	No	Price currency symbol (e.g., "USDT")
filters.min_quantity	number	No	Minimum quantity filter
filters.max_quantity	number	No	Maximum quantity filter
filters.seller_id	string	No	Filter by seller ID
filters.status	string	No	Filter by deal status

Response

Returns a paginated list of secondary market groups matching the search criteria.

Success Response (200 OK)

{
    "data": [
        {
            "deal_id": "number",
            "token_id": "string",
            "token_name": "string",
            "token_symbol": "string",
            "quantity": "number",
            "available_quantity": "number",
            "price": {
                "amount": "number",
                "decimal": "number",
                "symbol": "string"
            },
            "seller_id": "string",
            "seller_name": "string",
            "seller_rating": "number",
            "status": "string",
            "expires_at": "string",
            "created_at": "string",
            "updated_at": "string"
        }
    ],
    "pagination": {
        "current_page": 1,
        "per_page": 10,
        "total": "number",
        "total_pages": "number"
    },
    "filters_applied": {
        "token_id": "string",
        "min_price": "number",
        "max_price": "number",
        "price_symbol": "string",
        "min_quantity": "number",
        "max_quantity": "number",
        "seller_id": "string",
        "status": "string"
    }
}

Example

Request

curl -X POST "\{\{baseUrl\}\}/v2/users/secondary-markets/group-search" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer \{\{token\}\}" \
  -d '{
    "page": 1,
    "per_page": 10,
    "filters": {
        "min_price": 10,
        "max_price": 20,
        "price_symbol": "USDT",
        "status": "active"
    }
  }'

Response

{
    "data": [
        {
            "deal_id": 13,
            "token_id": "68ae06cfcccf4e8fc19362d1",
            "token_name": "Real Estate Token",
            "token_symbol": "RET",
            "quantity": 100,
            "available_quantity": 75,
            "price": {
                "amount": 12.5,
                "decimal": 6,
                "symbol": "USDT"
            },
            "seller_id": "680c02896d91ca0145cfeb82",
            "seller_name": "John Doe",
            "seller_rating": 4.8,
            "status": "active",
            "expires_at": "2024-02-15T10:30:00Z",
            "created_at": "2024-01-15T10:30:00Z",
            "updated_at": "2024-01-15T10:30:00Z"
        }
    ],
    "pagination": {
        "current_page": 1,
        "per_page": 10,
        "total": 1,
        "total_pages": 1
    },
    "filters_applied": {
        "min_price": 10,
        "max_price": 20,
        "price_symbol": "USDT",
        "status": "active"
    }
}

Error Responses

400 Bad Request

{
    "error": "Invalid request parameters",
    "details": "Invalid filter values"
}

401 Unauthorized

{
    "error": "Authentication required"
}

403 Forbidden

{
    "error": "Access denied"
}

500 Internal Server Error

{
    "error": "Internal server error"
}