Market Routes

These endpoints provide access to marketplace data, including listings, bids, sales, and user activity.

Get Listings by Collection

Returns market listings for a specific collection.

GET /api/market/listings-by-collection

Parameters

Name	Required	Description
creator	No*	Creator address of the collection
collection	No*	Name of the collection
lootboxId	No*	ID of the lootbox (alternative to creator/collection)

Note: You must provide either the creator/collection pair OR the lootboxId.

Example Request

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

Alternative Example (using lootboxId)

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

Response

Coming Soon

Get Bids by Collection

Returns market bids for a specific collection.

GET /api/market/bids-by-collection

Parameters

Name	Required	Description
creator	No*	Creator address of the collection
collection	No*	Name of the collection
lootboxId	No*	ID of the lootbox (alternative to creator/collection)

Note: You must provide either the creator/collection pair OR the lootboxId.

Example Request

fetch('https://api.crystara.trade/mainnet/market/bids-by-collection?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 Transaction History

Returns the 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

Search Collections and Tokens

Searches for collections and tokens by text.

GET /api/market/search

Parameters

Name	Required	Description
text	Yes	Search text

Example Request

fetch('https://api.crystara.trade/mainnet/market/search?text=crypto', {
  headers: {
    'x-api-key': 'your-api-key-here'
  }
})
.then(response => response.json())
.then(data => console.log(data));

Response

Coming Soon

Get Listing Cards

Returns paginated listing cards with various filtering options.

GET /api/market/listing-cards

Parameters

Name	Required	Description
page	No	Page number (default: 1)
limit	No	Number of results per page (default: 20)
search	No	Search text
minPrice	No	Minimum price filter
maxPrice	No	Maximum price filter
coinType	No	Filter by coin type
collectionName	No	Filter by collection name
creatorAddress	No	Filter by creator address
byPopular	No	Sort by popularity if true
collectionUrl	No	Filter by collection URL

Example Request

fetch('https://api.crystara.trade/mainnet/market/listing-cards?page=1&limit=20&minPrice=100&maxPrice=1000&collectionName=CryptoWarriors', {
  headers: {
    'x-api-key': 'your-api-key-here'
  }
})
.then(response => response.json())
.then(data => console.log(data));

Response

Coming Soon

Get Total Listing Cards

Returns the total count of listing cards matching the filter criteria.

GET /api/market/total-listing-cards

Parameters

Name	Required	Description
search	No	Search text
minPrice	No	Minimum price filter
maxPrice	No	Maximum price filter
coinType	No	Filter by coin type
collectionName	No	Filter by collection name
creatorAddress	No	Filter by creator address

Example Request

fetch('https://api.crystara.trade/mainnet/market/total-listing-cards?minPrice=100&maxPrice=1000&collectionName=CryptoWarriors', {
  headers: {
    'x-api-key': 'your-api-key-here'
  }
})
.then(response => response.json())
.then(data => console.log(data));

Response

Coming Soon

Get Listing Card Details

Returns detailed information about a specific token listing.

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

Get User Trading Activity

Returns a user's trading activity history.

GET /api/market/user-activity

Parameters

Name	Required	Description
address	Yes	User's wallet address
page	No	Page number (default: 1)
limit	No	Number of results per page (default: 20)

Example Request

fetch('https://api.crystara.trade/mainnet/market/user-activity?address=0x123abc...&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 User Listings

Returns a user's active listings.

GET /api/market/user-listings

Parameters

Name	Required	Description
address	Yes	User's wallet address
page	No	Page number (default: 1)
limit	No	Number of results per page (default: 20)

Example Request

fetch('https://api.crystara.trade/mainnet/market/user-listings?address=0x123abc...&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 User Bids

Returns a user's active bids.

GET /api/market/user-bids

Parameters

Name	Required	Description
address	Yes	User's wallet address
page	No	Page number (default: 1)
limit	No	Number of results per page (default: 20)

Example Request

fetch('https://api.crystara.trade/mainnet/market/user-bids?address=0x123abc...&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 User Purchase History

Returns a user's purchase history.

GET /api/market/user-history

Parameters

Name	Required	Description
address	Yes	User's wallet address
page	No	Page number (default: 1)
limit	No	Number of results per page (default: 20)

Example Request

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

Response

Coming Soon

Understanding Market Data

The market data returned by these endpoints includes:

• Listing Information: Seller, price, quantity, listing time
• Token Information: Creator, collection, token name, property version
• Price History: Historical price data (where available)
• Status: Whether the listing is active, sold, or cancelled

Prices are denominated in the smallest unit of the relevant currency (e.g., SUPRA).

Note: These routes were last updated June 2025.