Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Rarible NFT Items API

The NFT Items API from Rarible — 14 operation(s) for nft items.

Rarible NFT Items API is one of 18 APIs that Rarible publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include NFT Items. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and authentication docs.

This API exposes 14 operations across 14 paths, and defines 88 schemas. It is described by OpenAPI 3.0.3, at version v0.1.

Requests are made against a single base URL, https://{environment}.rarible.org.

14 operations 14 paths 88 schemas 1 DELETE9 GET4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
v0.1
Base URL
https://api.rarible.org/v0.1
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Rarible NFT Items API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-API-KEY (ApiKeyAuth). By default, every request must be authenticated.

Paths & Operations 14

Across 14 paths, the API surfaces 14 operations — 1 DELETE, 9 GET, 4 POST. Each is listed below with its method, path, parameters, and response codes.

NFT Items 14
GET
/v0.1/items/{itemId}
Get NFT by Id
getItemById 1 param → 200404400500
POST
/v0.1/items/byIds
Get NFT by Ids
getItemByIds body → 200404400500
GET
/v0.1/items/{itemId}/royalties
Get NFT royalties by Id
getItemRoyaltiesById 1 param → 200400500
DELETE
/v0.1/items/{itemId}/resetMeta
Reset NFT metadata
resetItemMeta 2 params → 200400500
GET
/v0.1/items/byOwner
Get NFT owned by user
getItemsByOwner 5 params → 200400500
GET
/v0.1/items/byCreator
Get NFT created by user
getItemsByCreator 5 params → 200400500
GET
/v0.1/items/byCollection
Get NFT from collection
getItemsByCollection 4 params → 200400500
GET
/v0.1/items/byOwnerWithOwnership
Get NFT owned by user - detailed
getItemsByOwnerWithOwnership 4 params → 200400500
GET
/v0.1/items/alldeprecated
Get all NFTs
getAllItems 7 params → 200400500
GET
/v0.1/items/traits
Get NFT collection traits
queryTraits 3 params → 200400500
POST
/v0.1/items/traits/rarity
Get NFT traits rarity
queryTraitsWithRarity body → 200
GET
/v0.1/items/lazy/{itemId}deprecated
Get Lazy NFT
getLazyItemById 1 param → 200404400500
POST
/v0.1/items/lazy/mintdeprecated
Mint Lazy NFT
mintLazyItem body → 200400404500
POST
/v0.1/items/lazy/burndeprecated
Burn Lazy NFT
burnLazyItem body → 204400404500

Schemas 88

The contract defines 88 schemas that model the data the API accepts and returns. The most detailed are Item (28 properties), Order (25 properties), EthOrderOpenSeaV1DataV1 (16 properties), Meta (14 properties). Each schema is shown below with its type and property counts.

EthErc1155LazyAssetType
object
9 properties 8 required
ItemIds
object
1 property 1 required
Trait
object
Combination of Item attribute key with list of values
2 properties 2 required
EthOrderBasicSeaportDataV1
object
1 property 1 required
UnionApiErrorServerError
object
2 properties 2 required
ItemCollection
object
4 properties 2 required
Traits
object
2 properties 1 required
SolanaSolAssetType
object
1 property 1 required
AssetType
object
Meta
object
14 properties 3 required
Payout
object
2 properties 2 required
BigDecimal
string
OrderData
object
EthErc20AssetType
object
2 properties 2 required
MetaAttribute
object
4 properties 1 required
EthLazyItemErc1155
object
2 properties 2 required
Items
object
3 properties 1 required
EthOrderDataRaribleV2DataV3
object
4 properties 4 required
ItemOwnership
object
9 properties 8 required
NftAssetType
object
4 properties 3 required
LazyItemMintForm
object
1 property 1 required
SolanaNftAssetType
object
4 properties 2 required
TokenCurrencyAssetType
object
2 properties 2 required
EthEthereumAssetType
object
2 properties 1 required
Asset
object
2 properties 2 required
ImageContent
object
3 properties
ItemWithOwnership
object
2 properties 2 required
EthOrderDataRaribleV2DataV1
object
3 properties 3 required
EthSeaportConsideration
object
6 properties 6 required
AudioContent
object
1 property
Order
object
25 properties 14 required
UnionApiErrorEntityNotFound
object
2 properties 2 required
EthCollectionAssetType
object
3 properties 2 required
Creator
object
2 properties 2 required
EthCryptoPunksAssetType
object
4 properties 3 required
EthRaribleV2OrderData
EthOrderDataRaribleV2DataV3Sell
object
6 properties 2 required
ItemTransfer
object
2 properties 4 required
VideoContent
object
3 properties
TraitEntry
object
Combination of Item attribute key/value with it's count
2 properties 2 required
RawOrderData
object
2 properties 1 required
EthLazyItem
object
EthOrderDataRaribleV2DataV2
object
4 properties 4 required
EthLazyItemErc721
object
1 property 1 required
OwnershipId
string
Rarity
object
2 properties
Royalty
object
2 properties 2 required
Item
object
28 properties 10 required
OrderId
string
CollectionId
string
Collection id
LazyItem
object
Type of an Asset
5 properties 5 required
TraitProperty
object
Item trait property
2 properties 2 required
ItemId
string
Item Id, has format ETHEREUM:${token}:${tokenId}
MetaContent
object
6 properties 2 required
EthErc721AssetType
object
4 properties 3 required
SearchEngine
string
EthOrderDataLegacy
object
2 properties 2 required
ItemsWithOwnership
object
3 properties 1 required
OrderStatus
string
EthOrderDataRaribleV2DataV3Buy
object
5 properties 1 required
EthSeaportItemType
string
ContractAddress
string
Blockchain contract address in Union format ETHEREUM:${token}
Platform
string
NativeCurrencyAssetType
object
3 properties 2 required
EthSeaportOffer
object
5 properties 5 required
NftOfCollectionAssetType
object
2 properties 2 required
ExtendedTraitProperties
object
2 properties 1 required
Model3dContent
object
1 property
LazyItemBurnForm
object
3 properties 3 required
BigInteger
string
EthOrderOpenSeaV1DataV1
object
16 properties 17 required
EthErc721LazyAssetType
object
8 properties 7 required
EthErc1155AssetType
object
4 properties 3 required
UnionApiErrorBadRequest
object
2 properties 2 required
RawJson
object
Blockchain
string
EthOrderCryptoPunksData
object
2 properties 1 required
EthOrderSeaportDataV1
object
9 properties 7 required
EthSeaportOrderType
string
TraitsRarityRequest
object
Request rarity of the properties in the collection
2 properties 2 required
HtmlContent
object
1 property
ExtendedTraitProperty
object
Trait property parameters with additional features
3 properties 3 required
EthGenerativeArtAssetType
object
3 properties 2 required
SolanaAuctionHouseDataV1
object
4 properties 1 required
Royalties
object
1 property 1 required
UnionAddress
string
Blockchain address in Union format ${blockchainGroup}:${token}
SolanaFtAssetType
object
2 properties 2 required
ItemLastSale
object
6 properties 6 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

rarible-nft-items-api-openapi.yml Raw ↑

Other APIs Rarible publishes across the network.

Rarible Charts API
Rarible Collection Leader Board API
Rarible Collection Statistics API
Rarible Currencies and rates API
Rarible Domain lookup API
Rarible Encode operations API
Rarible Indexer blocks API
Rarible NFT Activities API
Rarible NFT Collections API
Rarible NFT Data and Historical Statistics API
Rarible NFT Ownerships API
Rarible NFT Sales API