Deprecated API List

This is a list of deprecated APIs with a timeline for removal. We support deprecated APIs for 2 months before permanent removal.

API Deprecation

Snag Docs

Snag is the leading onchain loyalty platform, helping Web3 brands incentivize engagement, automate rewards and track user contributions. Power growth with customizable point-based programs and integrated marketplace features.

Welcome

Welcome to Snag Docs

Overview

Stratus overview

Subscriptions

Webhooks

Secure private key management for blockchain transactions

Relayers

Get started

Once you're marketplace is live, here’s everything you need to know to announce it to your community! Feel free to insert screenshots of your marketplace throughout the thread to enhance product visibility!

Launch marketplace

Snag API

Snag SDK

This endpoint enables you to upload a file to the resource. Returns a presigned URL and the asset's public URL. Call PUT with the file as the body to upload the asset using the presigned URL.

Get Asset upload URL

Returns a list of auction bids with optional filtering and pagination.

Get auction bids

Returns a list of auctions with optional filtering and pagination.

Get auctions

This endpoint is used to get user metadata

Get user metadata

This endpoint is used to create user metadata

Create user metadata

Get users

This endpoint returns the total user count

User count

This endpoint allows you to create a user

Connect a user to User Group

This endpoint allows you to disconnect a user from another user

Disconnect a user from User Group

This endpoint allows you to connect your Twitter account to a Snag account

Connect Twitter

Get loyalty accounts

Returns the user's rank determined by their loyalty points for the specified loyalty currency. This can be a slow operation for large organizations. We recommend caching when possible.

Get the rank of a user based on their loyalty points

Get loyalty currencies

Create a loyalty currency

Get Loyalty Multipliers

Create a new loyalty multiplier for a wallet.

Create Loyalty Multiplier

Delete a loyalty multiplier by its external identifier.

Delete Loyalty Multiplier by External Identifier

Update Loyalty Multiplier

Delete Loyalty Multiplier by ID

Retrieve configured loyalty rule edits with optional pagination and filters

Get Loyalty Rule Edits

Restore Loyalty Rule Edit

Get Loyalty Rule Groups

Create Loyalty Rule Groups

Update Loyalty Rule Group

Delete Loyalty Rule Group

Retrieve configured loyalty rules with optional pagination and filters

Get Loyalty Rules

Create Loyalty Rule

Update Loyalty Rule

Delete Loyalty Rule

Verify a loyalty rule based on user action and reward them if applicable. This endpoint currently only supports following rule types code_entry, text_input, link_click, discord_member, connect_wallet, check_in, external_rule, drip_x_follow, drip_x_new_tweet, drip_x_text_in_bio, drip_x_text_in_name, drip_x_text_in_comment, drip_x_tweet, telegram_join, DiscordMessages

Complete Loyalty Rule

This will return the processing status of quests for a specific user

Get Processing status for a specific user on loyalty rules

Create a loyalty transaction to update account balances.

Create Loyalty Transaction

Fetch loyalty transaction entries for wallets or users, representing account balance changes.

Get Loyalty Transaction Entries

Get Loyalty Rule Chains

This endpoint allows you to fetch badge(s) data.

Get badges (all or by id)

This endpoint allows you to configure a new badge.

Create new badge

This endpoint allows you to update an existing badge.

Update badge (by id)

This endpoint allows you to delete a badge.

Delete badge (by id)

This endpoint allows you to reward a badge for an account

Reward badge for account

This endpoint allows you to revoke a badge from an account

Revoke badge from account

Returns minting assets and any relevant context

Get minting assets

This endpoint allows you to fetch questions for a loyalty rule.

Get questions for a loyalty rule

This endpoint allows you to create a new question.

Create a new question

This endpoint allows you to update an existing question.

Update an existing question

Retrieve responses submitted by the authenticated user, optionally filtered by question IDs

Get user's question responses

This endpoint allows you to submit a response to a question.

Submit a response to a question

This endpoint allows you to create a referral code

Create referral code

This endpoint allows you to get referrals

Get referrals

This endpoint allows you to create a referral user

Create referral user

Returns a list of websites. Includes optional query parameters for filtering and pagination.

Get websites

Create website

Retrieves collections for a specific website.

Get Website Collections

Create Website Collection

Retrieves roles of users for a specific website. If userId is provided, retrieves the role of that specific user for the website.

Get roles of users for a website

Assign roles to users for a specific website

Assign roles to users for a website

Snag supports multiple authentication providers, allowing users to log in via wallets, email and social accounts. Our team will configure authentication for your platform based on the details you provide.

User authentication overview

Dynamic

Thirdweb

Privy

Immutable Passport

Sequence Wallet

Auth0

Contact Us

Loyalty Rules

API Reference

User Auth

Admin Dashboard

Explore Snag

This recipe is a quickstart guide to setting up your Snag Loyalty program, covering the loyalty currency configuration and initial rules set up.

Loyalty overview

After you have enabled loyalty program on your admin page, you will need to create a loyalty currency.

Set up loyalty currency

Available loyalty rules

These fields are common across all loyalty rules and define the general properties of a rule. They ensure consistency in rule setup and provide essential metadata for execution.

Rules configuration

Multipliers

Additional context for X (Twitter) rules logic

X rules logic

Create your first rule

Complete Profile

Refer a friend

Check-in

Connect Discord

Connect X

Connect Telegram

Connect Steam

Connect email

Connect Epic Games

Connect wallet

Reach X followers

Get Discord Role

Send Discord messages

Send Telegram messages

Join Telegram Channel

Follow X Account

Post New Tweet

X Text in Bio

X Text in Comment

X Text in Username

X Post Reaction

Hold a token

Token Purchase

Token Sale

Token Mint

Hold an ERC-20 Token

Contract Event

Code Entry

Link Click

Snapshot Governance

Text Input

This recipe explains the concept of a quiz rule, how to configure it with Snag and how to issue rewards to your users.

Quiz

This recipe explains the concept of a poll rule, how to configure it with Snag and how to issue rewards to your users.

Poll

Create Partner Account

This recipe explains how to create or update user accounts via the Snag API.

Managing user accounts

This recipe explains how to use Snag social integration API to let your users connect their social accounts to their Snag profile.

Managing social accounts

This recipe explains how to submit and verify loyalty rule completion via the Snag API.

Verifying rule completion

This recipe explains how to manually update user loyalty points balances (i.e. not as part of a rule completion or spend action; an example use-case is to reset all user point balances to 0).

Updating balances

The blocked users feature allows you to exclude specific wallet addresses from earning rewards through any loyalty rules. This is useful for blocking known bots, suspicious accounts or specific users.

Blocking Users

This recipe explains the concept of an external rule, how to configure it with Snag and how to issue rewards to your users.

External rule

Connect multiple wallets to aggregate points, earnings, and holdings to enhance your loyalty experience.

Multi-wallet Support

This recipe explains how to leverage the Snag API to fetch loyalty points balances for your users, which can be used to build features like a leaderboard in your application.

Leaderboards

This recipe explains how to create and manage badges in Snag Loyalty.

Badges

Internal currency integration

The Loyalty Builder tab in Snag’s admin tool allows you to customize your loyalty program page, manage currencies and balances and configure advanced leaderboard settings. Use this tool to tailor your loyalty experience and drive deeper engagement with your community.

Advanced functionality

Advanced loyalty functionality

Write and execute serverless JavaScript functions with Stratus

Functions

Learn how to create and validate Stratus functions with proper syntax, module restrictions, and best practices

Function syntax

Ready-to-use templates for common Stratus function patterns

Function Templates

The following will guide you through creating a user profile on Snag powered marketplaces, and the functionality available within profiles.

API Documentation

Asset

Auction

Identity

Loyalty

Badge

Minting

Question

Referrals

Website

API Deprecation

Deprecated API List

API Documentation

Asset

Auction

Identity

Loyalty

Badge

Minting

Question

Referrals

Website

​Deprecated API List

Deprecated API List