Token Routes

These endpoints provide access to token data, including collections, transactions, and balances.

Get Token Balances

Returns token balances for specici account addresses with enhanced filtering options.

GET /api/token-balances

Parameters

Name	Required	Description
address	Yes	Filter by wallet address
greaterThanZeroBalance	No	If true, only returns tokens with balance > 0
collection	No	Filter by collection name
creator	No	Filter by creator address
crystaraInfo	No	If true, includes additional Crystara-specific information

Example Request

fetch('https://api.crystara.trade/mainnet/token-balances?address=0x123abc...&greaterThanZeroBalance=true&crystaraInfo=true&collection=MyCollection&creator=0xabc123...', {
  headers: {
    'x-api-key': 'your-api-key-here'
  }
})
.then(response => response.json())
.then(data => console.log(data));

Response

Coming Soon

Get Tokens by Lootbox ID

Returns tokens associated with a specific lootbox ID.

GET /api/tokens-by-lootbox

Parameters

Name	Required	Description
lootboxId	Yes	Numeric ID of the lootbox

Example Request

fetch('https://api.crystara.trade/mainnet/tokens-by-lootbox?lootboxId=123', {
  headers: {
    'x-api-key': 'your-api-key-here'
  }
})
.then(response => response.json())
.then(data => console.log(data));

Response

Coming Soon

Get Tokens by Collection

Returns tokens in a specific collection with pagination support.

GET /api/tokens-by-collection

Parameters

Name	Required	Description
creator	Yes	Creator address of the collection
collection	Yes	Name of the collection
page	No	Page number (default: 1)
limit	No	Returned size (default: 50)

Example Request

fetch('https://api.crystara.trade/mainnet/tokens-by-collection?creator=0x123abc...&collection=CryptoWarriors&page=2', {
  headers: {
    'x-api-key': 'your-api-key-here'
  }
})
.then(response => response.json())
.then(data => console.log(data));

Response

Coming Soon

Get Tokens by Lootbox Creator

Returns tokens created by a specific lootbox creator for a collection.

GET /api/tokens-by-lootbox-creator

Parameters

Name	Required	Description
creator	Yes	Creator address
collection	Yes	Collection name

Example Request

fetch('https://api.crystara.trade/mainnet/tokens-by-lootbox-creator?creator=0x123abc...&collection=CryptoWarriors', {
  headers: {
    'x-api-key': 'your-api-key-here'
  }
})
.then(response => response.json())
.then(data => console.log(data));

Response

Coming Soon

Get Token Collection by Lootbox

Returns collection information for tokens in a specific lootbox.

GET /api/token-collection-by-lootbox-creator

Parameters

Name	Required	Description
creator	Yes	Creator address
collection	Yes	Collection name

Example Request

fetch('https://api.crystara.trade/mainnet/token-collection-by-lootbox-creator?creator=0x123abc...&collection=CryptoWarriors', {
  headers: {
    'x-api-key': 'your-api-key-here'
  }
})
.then(response => response.json())
.then(data => console.log(data));

Response

Coming Soon

Get Token Activity

Returns activity history for a specific token.

GET /api/token/activity

Parameters

Name	Required	Description
tokenName	Yes	Name of the token
creator	Yes	Creator address
collection	Yes	Collection name
propertyVersion	No	Property version of the token (default: '0')
page	No	Page number (default: 1)
limit	No	Number of results per page (default: 20)

Example Request

fetch('https://api.crystara.trade/mainnet/token/activity?tokenName=WarriorToken&creator=0x123abc...&collection=CryptoWarriors&page=1&limit=20', {
  headers: {
    'x-api-key': 'your-api-key-here'
  }
})
.then(response => response.json())
.then(data => console.log(data));

Response

Coming Soon

Get Token Traits

Returns trait information for a specific token.

GET /api/token/traits

Parameters

Name	Required	Description
collection	Yes	Collection name
creator	Yes	Creator address
tokenName	Yes	Name of the token
collectionUrl	No	URL of the collection
propertyVersion	No	Property version of the token (default: '0')
tokenStandard	No	Token standard (default: 'v1')

Example Request

fetch('https://api.crystara.trade/mainnet/token/traits?collection=CryptoWarriors&creator=0x123abc...&tokenName=WarriorToken&tokenStandard=v1', {
  headers: {
    'x-api-key': 'your-api-key-here'
  }
})
.then(response => response.json())
.then(data => console.log(data));

Response

Coming Soon

Get Token Transaction History

Returns transaction history for a specific token.

GET /api/market/token-history-by-tokenId

Parameters

Name	Required	Description
tokenId	Yes	ID of the token
page	No	Page number (default: 1)
limit	No	Number of results per page (default: 20)

Example Request

fetch('https://api.crystara.trade/mainnet/market/token-history-by-tokenId?tokenId=123&page=1&limit=20', {
  headers: {
    'x-api-key': 'your-api-key-here'
  }
})
.then(response => response.json())
.then(data => console.log(data));

Response

Coming Soon

Get Token Listing Details

Returns detailed listing information for a specific token.

GET /api/market/listing-card

Parameters

Name	Required	Description
tokenId	Yes	ID of the token
tokenStandard	Yes	Standard of the token (e.g., 'v1', 'v2')

Example Request

fetch('https://api.crystara.trade/mainnet/market/listing-card?tokenId=123&tokenStandard=v1', {
  headers: {
    'x-api-key': 'your-api-key-here'
  }
})
.then(response => response.json())
.then(data => console.log(data));

Response

Coming Soon

Note: These routes were last updated June 2025.