Skip to main content

​
API Design

The Krown Marketplace API follows REST principles and returns JSON responses. All endpoints are read-only and publicly accessible without authentication.

​
Base URL

https://api.krownlabs.app/api

​
Endpoints Overview

Collections

Query NFT collections, metadata, holders, and traits

Tokens

Get NFT data, ownership, listings, and rarity information

Activities

Track transfers, sales, offers, and marketplace events

Auctions

Browse active and completed auctions

Offers

View collection and token offers

Users

Get user profiles and NFT portfolios

​
Common Parameters

Most list endpoints support these parameters:

​
Pagination

ParameterTypeDefaultDescription
pageinteger1Page number
limitinteger50Results per page (max 100)

​
Sorting

ParameterTypeDefaultDescription
sortBystringvariesField to sort by
sortOrderstringdescSort order (asc or desc)

​
Filtering

Many endpoints support additional filters specific to the resource type.

​
Response Format

​
Success Response

{
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1000,
    "totalPages": 20,
    "hasNextPage": true,
    "hasPrevPage": false
  }
}

​
Error Response

{
  "error": "Error type",
  "message": "Human-readable error message"
}

​
HTTP Status Codes

CodeDescription
200Success
400Bad Request - Invalid parameters
404Not Found - Resource doesn’t exist
429Too Many Requests - Rate limit exceeded
500Internal Server Error

​
Data Freshness

  • Real-time: Activities, auctions, offers
  • Near real-time (< 30s): Token listings, ownership
  • Cached (2-5 min): Collection stats, holder lists, traits

​
Need Help?

Join Discord

Get support from our community and developers