Kullanıcıya Göre Token Al

Bir kullanıcı için belirli bir token hakkında detaylı bilgi alın.

Endpoint

GET /v2/users/tokens/{token_id}

Headers

Header	Değer
Content-Type	application/json
Authorization	Bearer {token}

Yol Parametreleri

Parametre	Tip	Gerekli	Açıklama
token_id	string	Evet	Token'ın benzersiz tanımlayıcısı

Yanıt

Belirtilen token hakkında detaylı bilgi döndürür.

Enum Değerleri

TokenStatus (Status)

Değer	Açıklama
0	None - Durum belirtilmemiş
1	Draft - Taslak durumda
2	InProgress - İşlem devam ediyor
3	Error - Hata durumunda
4	NotListed - Listelenmemiş
5	Delisted - Listeden çıkarılmış
6	Listed - Listelenmiş
7	Passive - Pasif durumda
8	Burn - Yakılmış

TokenType (Type)

Değer	Açıklama
0	StandardTokenType - Standart token tipi
1	DistributionTokenType - Dağıtım token tipi

DocumentType (Meta.Documents[].Type)

Değer	Açıklama
1	StandardDocumentType - Standart belge tipi

Başarılı Yanıt (200 OK)

{
    "id": "string",
    "name": "string",
    "symbol": "string",
    "description": "string",
    "value": "number",
    "value_symbol": "string",
    "rate": "number",
    "max_supply": "number",
    "total_supply": "number",
    "available_supply": "number",
    "status": "string",
    "category": {
        "id": "string",
        "name": "string"
    },
    "metrics": {
        "term_duration_in_months": "number",
        "min_purchase_quantity": "number",
        "max_purchase_quantity": "number",
        "min_tokens_required_for_rental_income": "number",
        "rental_income": "number",
        "rental_income_symbol": "string",
        "rental_payment_period_in_days": "number"
    },
    "created_at": "string",
    "updated_at": "string"
}

Örnek

İstek

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

Yanıt

{
    "id": "68ae06cfcccf4e8fc19362d1",
    "category_id": "667e9251ca818a2138ed4915",
    "type": 0,
    "node_id": "6810a8e5b45680e7d2f95bad",
    "node_name": "Oha",
    "listing_contract_address": "",
    "status": 6,
    "name": "DeriToken",
    "description": "Deri Token Deri Token",
    "token_name": "DeriToken",
    "token_symbol": "DRTN",
    "node_contract": {
        "listing_contract_address": "0xc54808e44455Daa9934F2739B45D8A0E3d67a3Ce",
        "rent_contract_address": "0xd5c8B37369E476d33aAAA99Ca7ABA49F9C6E0799",
        "burn_contract_address": "0xBDb62F7C7F9a2fA3F2ce1901A6fc10aae20b02Ad",
        "secondary_contract_address": "0x649F48e914bFA5F95bA0207D08AFee8490314910",
        "otc_contract_address": "0x433fA049c483b068963EbaBD650F66afb3d7789F"
    },
    "meta": {
        "images": [
            {
                "url": "https://fra1.digitaloceanspaces.com/apex/dev/token/68ae06cfcccf4e8fc19362d1/images/c476dc47-374f-4da9-a948-ecd76b9c8305.png",
                "is_default": true
            }
        ],
        "documents": []
    },
    "contract": {
        "address": "0x78fccec69e21dc0b331b59f283d4d5b41ff36654",
        "tx_hash": "0xa7cdc465c04ddfdbda5c1ab7e476766eb3c912f79921bd98e096358d7a7cdca0"
    },
    "value": {
        "token_price": {
            "amount": 0.9,
            "decimal": 6,
            "symbol": "USDT",
            "address": "0xdb2e8354c2a2a0f9c7c889ec27cdd424d49c8fd1"
        },
        "total_value": {
            "amount": 900,
            "decimal": 6,
            "symbol": "USDT",
            "address": "0xdb2e8354c2a2a0f9c7c889ec27cdd424d49c8fd1"
        },
        "salable_percentage": 30,
        "salable_value": {
            "amount": 270,
            "decimal": 6,
            "symbol": "USDT",
            "address": "0xdb2e8354c2a2a0f9c7c889ec27cdd424d49c8fd1"
        },
        "max_supply": 300,
        "listed_supply": 220,
        "sold_supply": 2
    },
    "distribution_token": null,
    "metric": {
        "term_duration_in_months": null,
        "min_purchase_quantity": 2,
        "max_purchase_quantity": 6,
        "min_tokens_required_for_rental_income": 4,
        "rental_income": {
            "amount": 2,
            "decimal": 6,
            "symbol": "USDT",
            "address": ""
        },
        "rental_payment_period_in_days": 30,
        "rental_payment_start_date": "2025-09-25T19:28:30.532Z",
        "listing_date": "2025-08-26T19:28:30.532Z"
    },
    "daily_rate_change": null,
    "weekly_rate_change": null,
    "monthly_rate_change": {
        "start_date": "2025-08-31T21:35:57.695Z",
        "end_date": "2025-09-01T19:26:14.776Z",
        "start_value": 1.4,
        "end_value": 0.9,
        "rate": -35.71,
        "change_type": -1
    },
    "created_at": "2025-08-26T19:11:11.177Z",
}

Hata Yanıtları

400 Bad Request

{
    "error": "Geçersiz token ID formatı"
}

401 Unauthorized

{
    "error": "Kimlik doğrulaması gerekli"
}

403 Forbidden

{
    "error": "Erişim reddedildi"
}

404 Not Found

{
    "error": "Token bulunamadı"
}

500 Internal Server Error

{
    "error": "İç sunucu hatası"
}