⚠️ DEPRECATED ⚠️ objkt.com public API v2

id (id)
amount (integer)
event_type (mint | list | cancel_list | ask_purchase | create_english_auction | cancel_english_auction | create_dutch_auction | cancel_dutch_auction | conclude_auction | dutch_purchase | offer | accept_offer | cancel_offer | offer_floor | accept_offer_floor | cancel_offer_floor | english_bid | transfer)
marketplace_event_type (list_create | list_cancel | list_buy | english_auction_create | english_auction_cancel | english_auction_bid | english_auction_settle | dutch_auction_create | dutch_auction_cancel | dutch_auction_buy | offer_create | offer_accept | offer_cancel | offer_floor_create | offer_floor_accept | offer_floor_cancel)
price (integer)
timestamp (utc_datetime)
ophash (string)
currency relationship to a single currency
currency_id
creator relationship to a single holder
creator_address
recipient relationship to a single holder
recipient_address
fa relationship to a single fa
fa_contract
marketplace relationship to a single marketplace_contract
marketplace_contract
token relationship to a single token
token_pk

fa

A Tezos contract, represents either an FA2 contract or an FA1.2 contract (see type.)

Holds info about a collection and different stats.

contract (string)
originated (string), contract that originated this contract
active_auctions (integer), number of active auctions
active_listing (integer), number of active listings
category (string)
collection_id (string)
collection_type (curated | auto | generative | artist | open | custom), artist means a collection created directly on objkt.com, curated means a collection of pieces from different artists who were hand-picked, generative means a collection where tokens were generated from a set of rules/layers, open means a collection where anyone can mint anything.
index_contract_metadata (boolean)
description (string)
floor_price (integer), cheapest listing in this collection in xtz
items (integer), number of tokens in this collection
editions (integer), total number of editions of all tokens in this collection
last_metadata_update (utc_datetime)
ledger_type (other | nft_asset | multi_asset)
level (integer)
live (boolean)
logo (string)
metadata (string)
name (string), collection name (or asset name for FA1.2 contract)
owners (integer), number of unique wallets holding a token from this collection
path (string)
short_name (string)
timestamp (utc_datetime)
token_link (string)
twitter (string), Twitter username used to link from collection page
type (fa1.2 | fa2)
tzip16_key (string)
volume_24h (integer)
volume_total (integer)
website (string), Website URL shown on collection page
updated_attributes_counts (utc_datetime)
creator relationship to a single holder
creator_address
collaborators relationship to a collection of invitation
tokens relationship to a collection of token
events relationship to a collection of event
attribute_counts relationship to a collection of fa2_attribute_count
asks relationship to a collection of obj_ask
offers relationship to a collection of obj_offer
english_auctions relationship to a collection of obj_english_auction
dutch_auctions relationship to a collection of obj_dutch_auction

fa2_attribute_count

Keeps track of attribute rarity per fa2.

id (id)
tokens (integer), how many tokens have this attribute in this fa2
editions (integer), how many tokens have this attribute in this fa2
fa relationship to a single fa
fa_contract
attribute relationship to a single attribute
attribute_id

hen_swap

DEPRECATED in favor of listing

A HenSwap is a listing on a hicetnunc-like marketplace contract.

A swap is uniquely identified by swap_id, contract.

Supported contracts are:

pk (id)
swap_id (integer)
contract (string)
amount (integer)
amount_left (integer)
level (integer)
price (integer)
royalties (integer)
status (active | concluded | cancelled)
timestamp (utc_datetime)
ophash (string)
seller relationship to a single holder
seller_address
token relationship to a single token
token_pk
trades relationship to a collection of hen_trade

hen_trade

DEPRECATED in favor of listing_sale

id (id)
price (integer)
level (integer)
timestamp (utc_datetime)
ophash (string)
swap relationship to a single hen_swap
swap_pk
token relationship to a single token
token_pk
seller relationship to a single holder
seller_address
buyer relationship to a single holder
buyer_address

holder

A holder is an implicit or originated tezos account.

address (string)
flag (none | banned | flagged | removed)
alias (string), Tezos Profiles alias (basic information)
logo (string), Tezos Profiles logo (basic information)
website (string), Tezos Profiles website (basic information)
description (string), Tezos Profiles description (basic information)
discord (string), Tezos Profiles verified discord account
ethereum (string), Tezos Profiles verified ethereum account
facebook (string), Tezos Profiles verified facebook account
github (string), Tezos Profiles verified github account
gitlab (string), Tezos Profiles verified gitlab account
instagram (string), Tezos Profiles verified instagram account
medium (string), Tezos Profiles verified medium account
reddit (string), Tezos Profiles verified reddit account
dns (string), Tezos Profiles verified dns account
slack (string), Tezos Profiles verified slack account
telegram (string), Tezos Profiles verified telegram account
twitter (string), Tezos Profiles verified twitter account
tzdomain (string), Tezos Domains reverse record
created_offer relationship to a collection of obj_offer
sold_offer relationship to a collection of obj_offer
target_offer relationship to a collection of obj_offer
created_english relationship to a collection of obj_english_auction
highest_bidders_english relationship to a collection of obj_english_auction
bidder_english relationship to a collection of obj_english_bid
created_event relationship to a collection of event
received_event relationship to a collection of event
created_fa2 relationship to a collection of fa
created_ask relationship to a collection of obj_ask
bought_ask relationship to a collection of obj_fulfilled_ask
sold_ask relationship to a collection of obj_fulfilled_ask
sent_ask relationship to a collection of obj_fulfilled_ask
target_ask relationship to a collection of obj_ask
created_dutch relationship to a collection of obj_dutch_auction
bought_dutch relationship to a collection of obj_fulfilled_dutch
sold_dutch relationship to a collection of obj_fulfilled_dutch
sent_dutch relationship to a collection of obj_fulfilled_dutch
sales_stats relationship to a collection of sales_stat
created_swap relationship to a collection of hen_swap
bought_trade relationship to a collection of hen_trade
sold_trade relationship to a collection of hen_trade
owner_operators relationship to a collection of token_operator
operator_operators relationship to a collection of token_operator
receiver_royalties relationship to a collection of royalties
created_tokens relationship to a collection of token_creator
held_tokens relationship to a collection of token_holder
collaborations relationship to a collection of invitation

invitation

id (id)
status (invited | accepted)
timestamp (utc_datetime)
update_timestamp (utc_datetime)
fa relationship to a single fa
fa_contract
holder relationship to a single holder
collaborator_address

listing

A Listing is something listed for direct sale, for instance: "I am selling X editions of token Y for Z xtz each."

id (id)
bigmap_key (integer), bigmap key of this listing in this marketplace_contract
amount (integer), how many editions are for sale in this listing
amount_left (integer), how many editions have not yet been sold on this listing
level (integer), block level
price (integer), price per edition in currency
start_price (integer)
end_price (integer)
shares ([]), royalties map
status (active | concluded | cancelled)
expiry (utc_datetime)
timestamp (utc_datetime)
update_level (integer)
update_timestamp (utc_datetime)
ophash (string), operation hash
update_ophash (string)
marketplace relationship to a single marketplace_contract
marketplace_contract
currency relationship to a single currency
currency_id
token relationship to a single token
token_pk
fa relationship to a single fa
fa_contract
seller relationship to a single holder
seller_address
target relationship to a single holder
target_address
listing_sales relationship to a collection of listing_sale

listing_sale

id (id)
amount (integer)
level (integer)
price (integer)
timestamp (utc_datetime)
ophash (string)
marketplace relationship to a single marketplace_contract
marketplace_contract
listing relationship to a single listing
listing_id
token relationship to a single token
token_pk
seller relationship to a single holder
seller_address
buyer relationship to a single holder
buyer_address
sender relationship to a single holder
sender_address

marketplace_contract

Contracts related to marketplace things (listings, offers, auctions, …)

We file MarketplaceContracts into groups and subgroups, and assign them an easily recognizable name.

contract (string)
name (string), the name we chose, it is not necessarily the 'official', on-chain metadata name of this contract
group (string), the 'organization' to which this contract belongs
subgroup (string), marketplace when it handles marketplace, i.e. listings/offers (it can also handle other things such as auctions), english when it only handles english auctions, dutch when it only handles dutch auctions
events relationship to a collection of event

obj_ask

DEPRECATED in favor of listing

An ask is a listing on objkt.com marketplace contract.

id (id)
amount (integer), how many editions are being sold via this listing
amount_left (integer), how many editions have not yet been sold on this listing
level (integer), block level
price (integer), price per edition in currency
shares ([]), royalties map
status (active | concluded | cancelled)
expiry (utc_datetime), timestamp at which the listing expires
timestamp (utc_datetime), timestamp at which the listing was created
update_level (integer), last level at which the record was modified
update_timestamp (utc_datetime), last time the record was modified
ophash (string), operation hash
contract_version (integer), the current marketplace contract is version 4
currency relationship to a single currency
currency_id
token relationship to a single token
token_pk
seller relationship to a single holder
seller_address
target relationship to a single holder
target_address
fa relationship to a single fa
fa_contract
fulfilled_asks relationship to a collection of obj_fulfilled_ask

obj_dutch_auction

DEPRECATED in favor of dutch_auction

id (id)
amount (integer)
amount_left (integer)
contract_version (integer)
end_price (integer)
end_time (utc_datetime)
expiry (utc_datetime)
hash (string)
level (integer)
shares ([])
start_price (integer)
start_time (utc_datetime)
status (active | concluded | cancelled)
timestamp (utc_datetime)
update_level (integer)
update_timestamp (utc_datetime)
ophash (string)
currency relationship to a single currency
currency_id
token relationship to a single token
token_pk
seller relationship to a single holder
seller_address
fa relationship to a single fa
fa_contract

obj_english_auction

DEPRECATED in favor of english_auction

id (id)
contract_version (integer)
end_time (utc_datetime)
extension_time (integer)
hash (string)
highest_bid (integer)
level (integer)
price_increment (integer)
reserve (integer)
shares ([])
start_time (utc_datetime)
status (active | concluded | cancelled)
timestamp (utc_datetime)
update_level (integer)
update_timestamp (utc_datetime)
ophash (string)
currency relationship to a single currency
currency_id
token relationship to a single token
token_pk
seller relationship to a single holder
seller_address
highest_bidder relationship to a single holder
highest_bidder_address
fa relationship to a single fa
fa_contract
bids relationship to a collection of obj_english_bid

obj_english_bid

DEPRECATED in favor of english_auction_bid

id (id)
amount (integer)
level (integer)
timestamp (utc_datetime)
ophash (string)
currency relationship to a single currency
currency_id
bidder relationship to a single holder
bidder_address
auction relationship to a single obj_english_auction
auction_id

obj_fulfilled_ask

DEPRECATED in favor of listing_sale

id (id)
amount (integer)
level (integer)
price (integer)
timestamp (utc_datetime)
ophash (string)
currency relationship to a single currency
currency_id
ask relationship to a single obj_ask
ask_id
token relationship to a single token
token_pk
seller relationship to a single holder
seller_address
buyer relationship to a single holder
buyer_address
sender relationship to a single holder
sender_address

obj_fulfilled_dutch

DEPRECATED in favor of dutch_auction_sale

id (id)
amount (integer)
level (integer)
price (integer)
timestamp (utc_datetime)
ophash (string)
currency relationship to a single currency
currency_id
dutch_auction relationship to a single obj_dutch_auction
dutch_auction_id
token relationship to a single token
token_pk
seller relationship to a single holder
seller_address
buyer relationship to a single holder
buyer_address
sender relationship to a single holder
sender_address

obj_offer

DEPRECATED in favor of offer

id (id)
level (integer)
price (integer)
shares ([])
floor_offer (boolean)
status (active | concluded | cancelled)
expiry (utc_datetime)
timestamp (utc_datetime)
update_level (integer)
update_timestamp (utc_datetime)
ophash (string)
contract_version (integer)
currency relationship to a single currency
currency_id
token relationship to a single token
token_pk
buyer relationship to a single holder
buyer_address
seller relationship to a single holder
seller_address
target relationship to a single holder
target_address
fa relationship to a single fa
fa_contract

offer

An Offer is a proposal made by a buyer to buy something, for instance: "I am offering X xtz for one edition of token Y."

A "collection offer" (aka "floor offer") is an offer that is valid for any item of a specific collection, for instance: "I am offering X xtz for any Tezzardz."

id (id)
bigmap_key (integer), bigmap key of this offer in this marketplace_contract
price (integer)
shares ([]), royalties map
collection_offer (string)
status (active | concluded | cancelled)
expiry (utc_datetime)
ophash (string)
update_ophash (string)
level (integer)
update_level (integer)
timestamp (utc_datetime)
update_timestamp (utc_datetime)
marketplace relationship to a single marketplace_contract
marketplace_contract
currency relationship to a single currency
currency_id
token relationship to a single token
token_pk
buyer relationship to a single holder
buyer_address
seller relationship to a single holder
seller_address
target relationship to a single holder
target_address
fa relationship to a single fa
fa_contract