Ana içeriğe geç

Kullanıcıya Göre Token'ları Al

Bir kullanıcıyla ilişkili token'ları arayın ve alın.

Endpoint

POST /v2/users/tokens/search

Headers

HeaderDeğer
Content-Typeapplication/json
AuthorizationBearer {token}

İstek Gövdesi

{
"page": 1,
"per_page": 10
}

Parametreler

ParametreTipGerekliAçıklama
pageintegerEvetSayfalama için sayfa numarası
per_pageintegerEvetSayfa başına öğe sayısı

Yanıt

Kullanıcıyla ilişkili token'ların sayfalı listesini döndürür.

Enum Değerleri

TokenStatus (Status)

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

TokenType (Type)

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

DocumentType (Meta.Documents[].Type)

DeğerAçıklama
1StandardDocumentType - Standart belge tipi

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

{
"data": [
{
"id": "68ae06cfcccf4e8fc19362d1",
"category_id": "667e9251ca818a2138ed4915",
"type": 0,
"node_id": "6810a8e5b45680e7d2f95bad",
"node_name": "",
"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",
}
],
"total": 2,
"page": 1,
"per_page": 10
}

Örnek

İstek

curl -X POST "\{\{baseUrl\}\}/v2/users/tokens/search" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer \{\{token\}\}" \
-d '{
"page": 1,
"per_page": 10
}'

Yanıt

{
"data": [
{
"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",
],
"total": 2,
"page": 1,
"per_page": 10
}

Hata Yanıtları

400 Bad Request

{
"error": "Geçersiz istek parametreleri"
}

401 Unauthorized

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

403 Forbidden

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

500 Internal Server Error

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