Admin OTC Group Search

Searches for OTC token groups for a specific node with pagination support.

Request

POST /v2/admin/otcs/nodes/{node_id}/group-search

Parameters

Name	Type	In	Description
node_id	string	Path. The ID of the node to search OTCs for

Request Body

Name	Type	Description
page	integer	Required. Page number for pagination
per_page	integer	Required. Number of items per page

Headers

Name	Type	Description
Authorization	Required. Bearer token for authentication
Content-Type	Required. application/json

Example

curl --location '\{\{baseUrl\}\}/v2/admin/otcs/nodes/6810a8e5b45680e7d2f95bad/group-search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \
--data '{
    "page": 1,
    "per_page": 10
}'

Response

{
    "data": [
        {
            "token_id": "68ae06cfcccf4e8fc19362d1",
            "total_count": 1,
            "token_address": "0x78fccec69e21dc0b331b59f283d4d5b41ff36654",
            "token_price_symbol": "USDT",
            "token_image": "https://fra1.digitaloceanspaces.com/apex/dev/token/68ae06cfcccf4e8fc19362d1/images/c476dc47-374f-4da9-a948-ecd76b9c8305.png",
            "token_name": "DeriToken",
            "token_symbol": "DeriToken",
            "token_status": 6,
            "token_category_id": "667e9251ca818a2138ed4915",
            "total_quantity": 1,
            "min_price": 5,
            "max_price": 5
        }
    ],
    "total": 1,
    "page": 1,
    "per_page": 10
}

Response Fields

Field	Type	Description
data	array	Array of OTC token groups
data[].token_id	string	Unique identifier of the token
data[].total_count	integer	Total number of OTC deals for this token
data[].token_address	string	Contract address of the token
data[].token_price_symbol	string	Price symbol (e.g., USDT)
data[].token_image	string	URL of the token image
data[].token_name	string	Name of the token
data[].token_symbol	string	Symbol of the token
data[].token_status	integer	Status of the token
data[].token_category_id	string	ID of the token category
data[].total_quantity	integer	Total quantity available in OTC
data[].min_price	number	Minimum price for this token in OTC
data[].max_price	number	Maximum price for this token in OTC
total	integer	Total number of items across all pages
page	integer	Current page number
per_page	integer	Number of items per page