Skip to main content

Public API Documentation

Important Information

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:

  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 "264439336" (ordered by createdAt, not id):

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