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:
status
query param of the getOrders endpoint, should be referenced asstatus[]
.
e.g. Request to get VALID or EXECUTED orders:
https://api.looksrare.org/api/v1/orders?status[]=VALID&status[]=EXECUTED
price
query param of the getOrders endpoint, should be referenced asprice[min]
and/orprice[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
pagination
query param of the getOrders and getEvents endpoint, should be referenced aspagination[first]
and/orpagination[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