API Reference

LooksRare Public API

📘

Important Information

LooksRare provides the API free of charge and asks that you give attribution to LooksRare on your platform (website or app) in return.

There should be a link to LooksRare from the NFTs or relative data that you display from the LooksRare API.

Please refer to Brand, Logos & Usage page for images that you can use for LooksRare attribution.

LooksRare reserves the right to revoke or restrict API access if the above terms are not adhered to.

General FAQs

What is the default rate limit?

120 requests per minute per IP address

Do I need an API key?

POST requests on mainnet require an API key.
GET requests and any request to a testnet endpoint do NOT require an API key.

Is there a cache on the API?

Yes, there's an API cache of 10 seconds currently.

Can I request a higher limit?

Yes. We have a developer discord available at https://discord.gg/LooksRareDevelopers

Can I create listings through the API?

Yes, but an API Key is required.

How can I obtain an API Key?

Please see How to request an API key

Does LooksRare have an SDK?

Yes. Our SDK can be found here: https://github.com/LooksRare/looksrare-sdk

Can I contact LooksRare about the API?

Yes. We have a developer discord available at https://discord.gg/LooksRareDevelopers

API usage FAQs

Some of my API calls aren't working. Why?

For some query params, they require to be in an array or an object, and they should be sent as follows:

  1. status query param of the getOrders endpoint, should be referenced as status[].

e.g. Request to get VALID or EXECUTED orders:

https://api.looksrare.org/api/v1/orders?status[]=VALID&status[]=EXECUTED
  1. price query param of the getOrders endpoint, should be referenced as price[min] and/or price[max].

e.g. Request to get listings at price of min 1.5 ETH and max 1.9 ETH

https://api.looksrare.org/api/v1/orders?price[min]=1500000000000000000&price[max]=1900000000000000000&isOrderAsk=true
  1. pagination query param of the getOrders and getEvents endpoint, should be referenced as pagination[first] and/or pagination[cursor].

e.g. Request to get first 5 orders:

https://api.looksrare.org/api/v1/orders?pagination[first]=5

e.g. Request to get 10 events before the event id "136422150" (ordered by createdAt, not id):

https://api.looksrare.org/api/v1/events?pagination[first]=10&pagination[cursor]=136422150