Skip to main content

Get Token Purchases

Get all purchases for a specific token with pagination support.

Endpoint: GET /api/v1/integration/tokens/{token_id}/purchases

Authentication: Required (Bearer token)

Required Headers:

Authorization: Bearer <access_token>
X-Target-Server: integration

Path Parameters

ParameterTypeRequiredDescription
token_idstring (UUID)YesToken ID

Query Parameters

ParameterTypeRequiredDescription
pageintegerNoPage number (default: 1)
per_pageintegerNoNumber of items per page (default: 20)

Response

Status: 200 OK

Returns a paginated list of purchases for the token.

{
"purchases": [
{
"id": "695d2d10385e3d666a37185a",
"quantity": 1,
"price": 1313.662723,
"currency": {
"symbol": "TRY",
"decimal": 6,
"address": "0x32d55702aef0e031f9264f9bbb20b3f89ee57a95"
},
"buyer_address": "0xa112983907944387B64ba512daF256B3f28f93f5",
"seller_address": "",
"hash": "0x10890efafbf3375427a43a0713ec05a91da34c53ba3d0cf11fff9c5d606abcdf",
"created_at": "2026-01-06T22:35:02.789563Z"
}
],
"total": 1,
"page": 1,
"per_page": 20
}

Example cURL Request

curl --location 'http://localhost:3458/api/v1/integration/tokens/26512436-045c-4c32-bd78-13b7dd9c24f3/purchases?page=1&per_page=20' \
--header 'X-Target-Server: integration' \
--header 'Authorization: Bearer <access_token>'