Skip to main content

Get Secondary Group

Get detailed information about secondary market groups for a specific token.

Endpoint​

GET /v2/users/secondary-markets/tokens/{token_id}

Headers​

HeaderValue
Content-Typeapplication/json
AuthorizationBearer {token}

Path Parameters​

ParameterTypeRequiredDescription
token_idstringYesThe unique identifier of the token

Response​

Returns detailed secondary market information for the specified token.

Success Response (200 OK)​

{
    "token_info": {
        "id": "string",
        "name": "string",
        "symbol": "string",
        "description": "string",
        "category": {
            "id": "string",
            "name": "string"
        }
    },
    "market_summary": {
        "total_deals": "number",
        "active_deals": "number",
        "total_quantity_available": "number",
        "total_volume_24h": "number",
        "volume_symbol": "string",
        "price_range": {
            "min": {
                "amount": "number",
                "decimal": "number",
                "symbol": "string"
            },
            "max": {
                "amount": "number",
                "decimal": "number",
                "symbol": "string"
            },
            "average": {
                "amount": "number",
                "decimal": "number",
                "symbol": "string"
            }
        }
    },
    "active_deals": [
        {
            "deal_id": "number",
            "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"
        }
    ]
}

Example​

Request​

curl -X GET "\{\{baseUrl\}\}/v2/users/secondary-markets/tokens/68ae06cfcccf4e8fc19362d1" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer \{\{token\}\}"

Response​

{
    "token_info": {
        "id": "68ae06cfcccf4e8fc19362d1",
        "name": "Real Estate Token",
        "symbol": "RET",
        "description": "Tokenized real estate investment opportunity",
        "category": {
            "id": "667e9251ca818a2138ed4885",
            "name": "Real Estate"
        }
    },
    "market_summary": {
        "total_deals": 15,
        "active_deals": 8,
        "total_quantity_available": 1250,
        "total_volume_24h": 25000,
        "volume_symbol": "USDT",
        "price_range": {
            "min": {
                "amount": 10.0,
                "decimal": 6,
                "symbol": "USDT"
            },
            "max": {
                "amount": 15.0,
                "decimal": 6,
                "symbol": "USDT"
            },
            "average": {
                "amount": 12.5,
                "decimal": 6,
                "symbol": "USDT"
            }
        }
    },
    "active_deals": [
        {
            "deal_id": 13,
            "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"
        }
    ]
}

Error Responses​

400 Bad Request​

{
    "error": "Invalid token ID format"
}

401 Unauthorized​

{
    "error": "Authentication required"
}

403 Forbidden​

{
    "error": "Access denied"
}

404 Not Found​

{
    "error": "Token not found"
}

500 Internal Server Error​

{
    "error": "Internal server error"
}