Documentation
What is LooksRareNFTs?
LooksRareNFTs is a real-time NFT sale notification service. When someone buys an NFT from a supported marketplace, the bot automatically detects the on-chain event and posts a sale announcement to your project's Twitter, Discord, and/or webhook endpoint — complete with token image, price in native currency and USD, and a link to the transaction.
How It Works
- Register your project — Add your NFT contract address and chain on the Projects page.
- Subscribe — Pay on-chain to activate monitoring for your project. Admin-owned projects are automatically active.
- Connect channels — Link your Twitter account, add a Discord webhook URL, or configure a custom webhook.
- Go live — Toggle your project to "Live" and the bot begins monitoring the blockchain for sales.
- Sale detected — When a sale occurs on a supported marketplace, the bot fetches token metadata and image, then posts to all connected channels.
Notification Channels
Connect your project's Twitter account via OAuth. Each sale is posted as a tweet with the token image, sale price, buyer/seller addresses, and a link to the transaction on the block explorer. Each project uses its own Twitter access tokens, so sales post from the project's own account.
Discord
Add a Discord webhook URL and the bot will send rich embeds to your channel for every sale. Embeds include token image, metadata, price, and marketplace link. To create a webhook, go to your Discord channel's settings and look for Integrations > Webhooks.
Webhooks
Configure a custom webhook URL to receive sale events as JSON payloads. Each payload includes the project, token, price, buyer, seller, transaction hash, and image URL. You can optionally provide a custom JSON template to transform the payload to match your system's format.
Subscriptions
Projects require an active subscription to monitor sales. Subscriptions are paid in USDC on-chain via the subscription smart contract. You choose how many days to subscribe, and can top up at any time. The daily price is set by the platform admin.
How to subscribe: Go to your project page, click "Subscribe", choose the number of days, and confirm the transaction in your wallet.
Renewal: You can extend your subscription at any time by subscribing again. Days are added to your current expiry.
Circuit Breakers
Each notification channel (Twitter, Discord, Webhook) has a circuit breaker that automatically pauses delivery after repeated failures — for example, if a Discord webhook URL is deleted or Twitter credentials expire. This prevents the bot from endlessly retrying broken integrations.
When a circuit breaker trips, it shows on your project page. You can fix the underlying issue (re-authenticate Twitter, update your Discord webhook URL, etc.) and then reset the circuit breaker to resume notifications.
Team Management
Project owners can invite other users to help manage their project. Team members are identified by their Twitter handle and must have logged in at least once. There are three roles:
| Role | Permissions |
|---|---|
| Viewer | View project settings and sales data |
| Editor | Modify settings, connect channels, toggle live, reprocess transactions |
| Owner | Full access including team management and project deletion |
Reprocessing Transactions
If a sale notification was missed or you want to re-send it, you can reprocess a transaction from the project page. Paste the full transaction hash (0x...) and the bot will re-fetch the sale data and post it to all connected channels. The previous database entry for that transaction is cleared before reprocessing.
Supported Chains & Exchanges
The bot monitors the following marketplace contracts for NFT sale events. Only sales that occur through these contracts are detected. If your project trades on a marketplace not listed here, contact the platform admin to request support.