Public API Documentation
LooksRare API is currently in BETA and will be undergoing regular maintenance to increase data offerings and improve performance.
LooksRare provides the API free of charge, and ask that you provide attribution to LooksRare on your platform (website and/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 in the event that the above terms are not adhered to.
Public API Documentation
LooksRare Public API Docs: https://looksrare.dev/
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?
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 before the event id "264439336" (ordered by createdAt, not id):
https://api.looksrare.org/api/v1/events?pagination[first]=10&pagination[cursor]=264439336