Asset Discovery

In order to get latest information about API, please follow OpenAPI doc for item-controller part

There are some controllers to query items:

These controllers have common parameters:

  • size - how many items you want to get

  • continuation - send this parameter to fetch next portion of data (you can find continuation value in the server response)

  • also they have different query parameters for each. Please, see api-reference

get
Item Metadata

http://api.rarible.com/protocol/v0.1/ethereum/nft/items/:itemId/meta
Displays all item Metadata (Stored on IPFS)
Request
Response
Request
Path Parameters
itemId
required
string
The itemId is built by using collectionAddress:tokenId - An example is 0x60f80121c31a0d46b5279700f9df786054aa5ee5:21
Response
200: OK
{
"name": "string",
"description": "string",
"image": "string",
"external_url": "string",
"animation_url": "string",
"attributes": {}
}

get
Item Data

http://api.rarible.com/protocol/v0.1/ethereum/nft/items/:itemId
Displays Item data such as Royalties, Unlockable content, etc.
Request
Response
Request
Path Parameters
itemId
required
string
The itemId is built by using collectionAddress:tokenId - An example is 0x60f80121c31a0d46b5279700f9df786054aa5ee5:21
Response
200: OK
{
"id": "string",
"token": "string",
"tokenId": 0,
"unlockable": true,
"creator": "string",
"supply": 0,
"owners": [
"string"
],
"royalties": [
{
"recipient": "string",
"value": 0
}
]
}

If you wish to build an order for an ERC1155, it is important you also record the amount returned by the query.

Visit the next section on how to create a sell order!