Admin Get OTC Token Deals

Retrieves OTC deals for a specific token and node with pagination support.

Request

POST /v2/admin/otcs/nodes/{node_id}/tokens/{token_id}

Parameters

Name	Type	In	Description
node_id	string	Path. The ID of the node
token_id	string	Path. The ID of the token to get deals 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/tokens/68ae06cfcccf4e8fc19362d1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \
--data '{
    "page": 1,
    "per_page": 10
}'

Response

{
    "data": [
        {
            "id": "68bf5152932e6bcb90859816",
            "token_id": "68ae06cfcccf4e8fc19362d1",
            "node_id": "6810a8e5b45680e7d2f95bad",
            "user_id": "680c02896d91ca0145cfeb81",
            "deal_id": 2,
            "price": {
                "amount": 5,
                "decimal": 6,
                "symbol": "USDT",
                "address": "0xdb2e8354c2a2a0f9c7c889ec27cdd424d49c8fd1"
            },
            "quantity": 1,
            "status": 0,
            "created_at": "2025-09-08T21:37:00Z",
            "updated_at": "2025-09-08T21:37:00Z"
        }
    ],
    "total": 1,
    "page": 1,
    "per_page": 10
}

Response Fields

Field	Type	Description
data	array	Array of OTC deals
data[].id	string	Unique identifier of the deal
data[].token_id	string	ID of the token
data[].node_id	string	ID of the node
data[].user_id	string	ID of the user who created the deal
data[].deal_id	integer	Deal identifier number
data[].price	object	Price information
data[].price.amount	number	Price amount
data[].price.decimal	integer	Decimal places for the price
data[].price.symbol	string	Price symbol (e.g., USDT)
data[].price.address	string	Contract address of the price token
data[].quantity	integer	Quantity of tokens in the deal
data[].status	integer	Status of the deal (0 = active)
data[].created_at	string	ISO 8601 timestamp when the deal was created
data[].updated_at	string	ISO 8601 timestamp when the deal was last updated
total	integer	Total number of items across all pages
page	integer	Current page number
per_page	integer	Number of items per page