Skip to main content
POST
/
get-tokens
Get tokens list
curl --request POST \
  --url https://yppncslmsswqydhhgygz.supabase.co/functions/v1/get-tokens \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "hashtag_name": "defi",
  "filter": "trending",
  "limit": 20,
  "offset": 0,
  "verified_only": false
}'
{
  "success": true,
  "tokens": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "symbol": "<string>",
      "slug": "<string>",
      "logo": "<string>",
      "banner_url": "<string>",
      "video_url": "<string>",
      "description": "<string>",
      "token_layer_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "launch_post_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "total_posts_count": 1,
      "total_media_count": 1,
      "groups_count": 1,
      "holders_count": 1,
      "upvotes": 1,
      "downvotes": 1,
      "weighted_upvotes": 1,
      "weighted_downvotes": 1,
      "user_vote": "upvote",
      "is_live": true,
      "hashtags": [
        "<string>"
      ],
      "creator": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "username": "<string>",
        "profile_picture": "<string>"
      }
    }
  ],
  "pagination": {
    "limit": 1,
    "offset": 1,
    "total_returned": 1,
    "has_more": true
  }
}

Authorizations

​
Authorization
string
header
required

JWT token or API key

Body

application/json
​
filter
enum<string>
required

Sorting/filtering strategy for tokens

Available options:
trending,
new,
popular,
top_posts
Example:

"trending"

​
hashtag_name
string

Filter tokens by hashtag name

Example:

"defi"

​
limit
integer
default:20

Maximum number of tokens to return

Required range: 1 <= x <= 100
Example:

20

​
offset
integer
default:0

Number of tokens to skip for pagination

Required range: x >= 0
Example:

0

​
verified_only
boolean
default:false

Only return tokens with token_layer_id (verified)

Example:

false

Response

Successful response

​
success
boolean
required
​
tokens
object[]
required
​
pagination
object
required

Pagination information