Documentation ArkProject

GETcollections/{address}/{chain_id}/tokens

List Tokens in a Specific Collection

This endpoint allows you to retrieve a list of all tokens in 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.

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.
Name
buy_now
Type
boolean
Description
Filter tokens that are available for immediate purchase. Defaults to false if not provided.
Name
sort
Type
string
Description
The field to sort by. Defaults to "price" if not provided.
Name
direction
Type
string
Description
The direction to sort in. Can be either "asc" or "desc". Defaults to "desc" if not provided.

Request

GET

collections/{address}/{chain_id}/tokens

curl "https://api.marketplace.arkproject.dev/collections/{address}/{chain_id}/tokens?page=1&items_per_page=100&buy_now=false&sort=price&direction=desc"

Response

{
  "data": [
    {
      "contract": "0x05dbdedc203e92749e2e746e2d40a768d966bd243df04a6b712e222bc040a9af",
      "token_id": "0x000000000000000000000000000000000000000000000000000000000098db9a",
      "last_price": "100",
      "floor_difference": "10",
      "listed_at": 1234567890,
      "owner": "0x00a69e64b09ef9830305c3e3166e2b42b3b38edd054c18a9105974f7eb949826",
      "minted_at": 1234567890,
      "updated_at": 1234567890,
      "price": "100",
      "metadata": {
        "name": "Ark Token",
        "description": "This is an Ark token",
        "image": "https://example.com/image.png"
      }
    }
  ],
  "token_count": 1,
  "next_page": 2
}

GETportfolio/{user_address}

List All Tokens for a User's Portfolio

This endpoint allows you to retrieve a list of all tokens for a user's portfolio.

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.
Name
buy_now
Type
boolean
Description
Filter tokens that are available for immediate purchase. Defaults to false if not provided.
Name
sort
Type
string
Description
The field to sort by. Defaults to "price" if not provided.
Name
direction
Type
string
Description
The direction to sort in. Can be either "asc" or "desc". Defaults to "desc" if not provided.
Name
collection
Type
string
Description
Filter tokens that belong to a specific collection. Defaults to all collections if not provided.

Request

GET

portfolio/{user_address}

curl "https://api.marketplace.arkproject.dev/portfolio/{user_address}?page=1&items_per_page=100&buy_now=false&sort=price&direction=desc&collection=collection_address"

Response

{
  "data": [
    {
      "contract": "0x05dbdedc203e92749e2e746e2d40a768d966bd243df04a6b712e222bc040a9af",
      "token_id": "0x000000000000000000000000000000000000000000000000000000000098db9a",
      "list_price": "100",
      "best_offer": "200",
      "floor": "100",
      "received_at": 1234567890,
      "metadata": {
        "name": "Ark Token",
        "description": "This is an Ark token",
        "image": "https://example.com/image.png"
      }
    }
  ],
  "token_count": 1,
  "next_page": 2
}