Admin OTC Group Search

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

Request

GET /v2/admin/otcs?node_id={node_id}

Parameters

Name	Type	In	Description
node_id	string	query	Required. The node whose OTC offers are listed
page	integer	query	Required. Page number, minimum 1
per_page	integer	query	Required. Items per page, 1–100

The node moved from the path to a query filter and the call became a GET: it is a plain listing, and the paging that used to travel in a JSON body now travels in the URL. There is no request body.

Headers

Name	Type	Description
Authorization	Required. Bearer token for authentication

Example

curl --location '\{\{baseUrl\}\}/v2/admin/otcs?node_id=6810a8e5b45680e7d2f95bad&page=1&per_page=10' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'

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