Skip to content

art-technologies/verse-discord-bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Verse Discord Bot

Introduction

Verse Discord bot allows to stream real time marketplace events to your Discord server. It can be configured to send events for sales, listings and offers including both Verse and OpenSea.

Note: OpenSea events will work only for projects that exist on Verse.

Add it to your Discord server

In order to start using Verse discord bot you should

  1. Invite Verse Discord Bot to your server and create a channel for the events.
  2. Identify what events you want to show in your Discord server and create configuration.
  3. Make Pull Request to guilds.json with your configuration requirements based. If you are can't make Pull Request please reach out to us at support@verse.works.
  4. Once we approve Pull Request your Discord channel will start receiving events.

Configuration

Bot configuration describes what sale/offer/lising events to send and where to send them. The most general bot configuration is the following and consists of channel_id and optional filters for collections, artists and collaborators.

{
  "channel_id": "123",
  "filters": {
    "collections": ["33-million-by-anna-lucia"],
    "collaborators": ["tender", "verse-solos"],
    "artists": ["anna-lucia"],
    "events": [
      "PM_SALE",
      "SM_LISTED",
      "SM_SALE",
      "SM_OFFER",
      "SM_GLOBAL_OFFER",
      "OS_SALE",
      "OS_OFFER",
      "OS_LISTED"
    ]
  }
}

You get your Discord channel ID by right clicking on the channel and "Copy Channel ID".

Filters

If you don't want to receive all the events you can specify optional filters to receive only the events you want.

Artists filter

Allows you to receive events only for one or more specific artists.

Collaborators filter

Allows you to reeive events only for one or more specific collaborators/galleries.

Collcetions filter

Allows you to receive events only for one or more specific collections.

Events filter

Allows to specify what kind of sale, offer or listing events should be sent.

Event Description
PM_SALE Verse primary market sale events
SM_LISTED Verse secondary market listing events
SM_SALE Verse secondary market sale events
SM_OFFER Verse offer events
SM_GLOBAL_OFFER Verse secondary market offer events
OS_SALE OpenSea secondary market sale events
OS_OFFER OpenSea offer events
OS_LISTED OpenSea secondary market listing events

Configuration examples

Examples for commonly used filters

Example 1

All events (sale, listing, offer) for Tender gallery.

{
  "channel_id": "123",
  "filters": {
    "collaborators": ["tender"]
  }
}

Example 2

All events (sale, listing, offer) for artist qubibi.

{
  "channel_id": "123",
  "filters": {
    "artists": ["qubibi"]
  }
}

Example 3

Sale events for Quasi Dragon Studies collection.

{
  "channel_id": "123",
  "filters": {
    "collections": ["quasi-dragon-studies-by-harvey-rayner"],
    "events": ["PM_SALE", "SM_SALE", "OS_SALE"]
  }
}

Releases

No releases published

Packages

No packages published