GETcollections

List All Collections

This endpoint allows you to retrieve a list of all collections.

Query parameters

  • Name
    page
    Type
    integer
    Description

    The page number to fetch. Defaults to 1 if not provided.

  • Name
    items_per_page
    Type
    integer
    Description

    The number of items to fetch per page. Defaults to 100 if not provided.

Request

GET
collections
curl "https://api.marketplace.arkproject.dev/collections?page=1&items_per_page=100"

Response

{
  "data": [
    {
      "collection_id": "0x05dbdedc203e92749e2e746e2d40a768d966bd243df04a6b712e222bc040a9af",
      "collection_name": "Ark Collection",
      "collection_description": "This is an Ark collection",
      "collection_image": "https://example.com/image.png"
    }
  ],
  "collection_count": 1,
  "next_page": 2
}
GETcollections/{address}/{chain_id}

Get a Specific Collection

This endpoint allows you to retrieve a specific collection.

Path parameters

  • Name
    address
    Type
    string
    Description

    Address of the collection.

  • Name
    chain_id
    Type
    string
    Description

    Chain ID of the collection.

Request

GET
collections/{address}/{chain_id}
curl "https://api.marketplace.arkproject.dev/collections/{address}/{chain_id}"

Response

{
  "data": {
    "collection_id": "0x05dbdedc203e92749e2e746e2d40a768d966bd243df04a6b712e222bc040a9af",
    "collection_name": "Ark Collection",
    "collection_description": "This is an Ark collection",
    "collection_image": "https://example.com/image.png"
  }
}
GET/portfolio/{user_address}/collections

List All Collections for a User's Portfolio

This endpoint allows you to retrieve a list of all collections for a user's portfolio. The response includes the collections data, the total number of collections, and the next page number if there are more collections to fetch.

Path parameters

  • Name
    user_address
    Type
    string
    Description

    Address of the user.

Query parameters

  • Name
    page
    Type
    integer
    Description

    The page number to fetch. Defaults to 1 if not provided.

  • Name
    items_per_page
    Type
    integer
    Description

    The number of items to fetch per page. Defaults to 100 if not provided.

Request

GET
/portfolio/{user_address}/collections?page=1&items_per_page=100
curl "https://api.marketplace.arkproject.dev/portfolio/{user_address}/collections?page=1&items_per_page=100"

Response

{
  "data": [
    {
      "address": "0x05dbdedc203e92749e2e746e2d40a768d966bd243df04a6b712e222bc040a9af",
      "image": "https://example.com/image.png",
      "collection_name": "Ark Collection",
      "floor": 100,
      "token_count": 20,
      "user_token_count": 10,
      "user_listed_tokens": 5,
      "is_verified": true,
    },
    {
      "address": "0x05dbdedc203e92749e2e746e2d40a768d966bd243df04a6b712e222bc040a9af",
      "image": "https://example.com/image.png",
      "collection_name": "Ark Collection 2",
      "floor": 200,
      "token_count": 40,
      "user_token_count": 20,
      "user_listed_tokens": 10,
      "is_verified": false,
    }
  ],
  "collection_count": 2,
  "next_page": 2
}