⚠️ DEPRECATED ⚠️ objkt.com public API v1
In February 2022, we released version 2 of Objkt.com Public API. We will sunset v1 on April 30, 2022.
Please migrate to v2 immediately.
Deprecated V1 Documentation
- Endpoint: https://data.objkt.com/v1/graphql
- Explorer: GraphiQL
Limits
- 120 requests per minute
- Max 250 results, paginate based on the last pk/id to retrieve everything
- No subscriptions / live queries / websocket
Schema
All queries exist as entity
and entity_pk
, the latter letting you query directly by Primary Key.
Entities
holder
A wallet
address
flag = 'none' | 'banned' | 'flagged'
last_metadata_update
tzdomain
reverse record from tezos.domainsalias
from TzKT alias verificationdescription
from TzKT alias verificationsite
from TzKT alias verificationsupport
from TzKT alias verificationemail
from TzKT alias verificationtwitter
from TzKT alias verificationtelegram
from TzKT alias verificationdiscord
from TzKT alias verificationreddit
from TzKT alias verificationslack
from TzKT alias verificationgithub
from TzKT alias verificationgitlab
from TzKT alias verificationinstagram
from TzKT alias verificationfacebook
from TzKT alias verificationmedium
from TzKT alias verification
attribute
See https://tzip.tezosagora.org/proposal/tzip-21/
id
pkname
type
value
token_attribute
token
relationship totoken
attribute
relationship toattribute
token
pk_id
pkfa2
relationship tofa2
id
token idcreator
relationship toholder
title
description
artifact_uri
display_uri
thumbnail_uri
metadata
extra
mime
royalties
per mille: 100 = 10%supply
last_listed
highest_bid
lowest_ask
flag = 'none' | 'banned' | 'flagged'
level
timestamp
last_metadata_update
tag
id
name
token_tag
token
relationship totoken
tag
relationship totag
token_holder
Which wallet owns how many of which token
holder
relationship toholder
token
relationship totoken
quantity
last_incremented
hen_swap
HEN swaps v2
id
pkcreator
relationship toholder
token
relationship totoken
price
mutezamount
number of editions swappedamount_left
number of editions still for salestatus = 'active' | 'finished' | 'cancelled'
royalties
per milleis_valid
false when royalties don't match token royaltiestimestamp
hen_trade
Executed swaps
id
pktoken
relationship totoken
swap
relationship toSwap
seller
relationship toholder
buyer
relationship toholder
amount
timestamp
fa2_collaborators
fa2
relationship tofa2
collaborator
relationship toholder
signed
fa2
A collection / an FA2 contract
contract
KT1 addresslive
bool, supported/shown or hidden/unknownname
short_name
description
type = 'curated' | 'generative' | 'open'
category = 'art' | 'collectible' | 'music' | 'trading card' | 'utilities'
path
objkt.com path to collectionhttps://objkt.com/collection/<path>
token_link
link[#token_id](token_link)
on a token pagelogo
twitter
website
metadata
collection_type = 'artist' | 'open' | 'custom'
where 'artist' indicates collections created via objkt.com minting featurecollection_id
creator
relationship toholder
volume_total
volume_24h
owners
owners countitems
items countfloor_price
active_listing
active_auctions
timestamp
last_metadata_update
obj_english_auction
An English auction
id
pkhash
used in URLhttps://objkt.com/auction/e/<hash>
fa2
relationship tofa2
status = 'active' | 'concluded' | 'cancelled'
token
relationship totoken
creator
relationship toholder
artist
relationship toholder
royalties
mutezstart_time
end_time
extension_time
price_increment
reserve
contract_version
highest_bid
highest_bidder
relationship toholder
level
timestamp
update_timestamp
obj_english_bid
A bid on an English auction
id
pkbidder
relationship toholder
amount
auction
relationship toEnglishAuction
level
timestamp
obj_dutch_auction
A Dutch auction
id
pkhash
used in URLhttps://objkt.com/auction/d/<hash>
fa2
relationship tofa2
status = 'active' | 'concluded' | 'cancelled'
token
relationship totoken
creator
relationship toholder
artist
relationship toholder
royalties
mutezstart_time
end_time
start_price
mutezend_price
mutezbuyer
relationship toholder
buy_price
contract_version
level
timestamp
update_level
update_timestamp
obj_bid
An offer placed on a token
id
pkcreator
relationship toholder
artist
relationship toholder
token
relationship totoken
fa2
relationship tofa2
price
mutezroyalties
mutezstatus = 'active' | 'concluded' | 'cancelled'
seller
relationship toholder
level
timestamp
update_level
update_timestamp
obj_ask
A listing, i.e. someone trying to sell a token or editions of a token for a fixed price.
id
pkcreator
relationship toholder
artist
relationship toholder
token
relationship totoken
fa2
relationship tofa2
price
mutezroyalties
mutezamount
amount_left
status = 'active' | 'concluded' | 'cancelled'
level
timestamp
update_timestamp
obj_fulfilled_ask
An ask that sold
id
pktoken
relationship totoken
ask
relationship toobj_ask
seller
relationship toholder
buyer
relationship toholder
amount
number of editionsprice
mutezlevel
timestamp
event
id
pktoken
relationship totoken
fa2
relationship tofa2
creator
relationship toholder
recipient
relationship toholder
price
mutezamount
type = 'list' | 'create_english_auction' | 'create_dutch_auction' | 'purchase' | 'offer' | 'accept_offer' | 'english_bid' | 'transfer'
timestamp
tzd_tld
tezos.domains TLD
id
pkowner
address
tzd_domain
tezos.domains domain
id
pktld
relationship totzd_tld
expiry
owner
addresstoken_id
tzd_record
tezos.domains record
id
pkdomain
relationship totzd_domain
target
relationship toholder