Skip to main content

Public API Documentation

Important Information

LooksRare API is currently in BETA and will be undergoing regular maintenance to increase our data offerings and improve performance.

Please take this into consideration when utilizing LooksRare API


Public API Documentation

LooksRare Public API Docs: https://looksrare.github.io/api-docs/

General FAQs

What is the default rate limit

120 requests per minute per IP address

Is there a cache on the API?

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

Can I request a higher limit?

Please see Can I contact LooksRare about the API?

Can I create listings through the API?

Yes, but an API Key is required.

How can I obtain an API Key?

Please see Can I contact LooksRare about the API?

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 discord.gg/LooksRareDevelopers

API usage FAQs

Some of my API calls aren't working

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 after the event id "136422150" (ordered by createdAt, not id):

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