List Projects in Narrative

Testing

GET

/narratives/{narrative_id_or_slug}/projects

Retrieves a paginated list of projects belonging to a specific narrative, along with key stats.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://public-api.protokols.io/api/v1/narratives/gaming/projects?cursor&limit&sort_by&sort_order' \
--header 'authorization: Bearer 99f0c8fbb6df52400c8edac910f9dbb3be93faea06ba928bba24011252409c4a'

Response Example

200 - Example 1

{
    "data": [
        {
            "twitter_profile": {
                "id": "string",
                "username": "string",
                "avatar_url": "string",
                "description": "string",
                "display_name": "string",
                "followers_count": 0,
                "lang": "string",
                "following_count": 0,
                "is_verified": true,
                "profile_created_at": "string",
                "description_link": "string",
                "gold_badge": true
            },
            "coin": {
                "name": "string",
                "symbol": "string",
                "image_url": "string",
                "market_cap": 0,
                "price": 0,
                "contract_address": "string"
            },
            "mindshare": {
                "mindshare_percent": 0,
                "change_24h": 0,
                "change_7d": 0,
                "change_30d": 0,
                "change_90d": 0
            },
            "total_views": 0,
            "total_posts": 0
        }
    ],
    "pagination": {
        "page": 0,
        "limit": 0,
        "cursor": "string"
    }
}

Request

Path Params

narrative_id_or_slug

string

required

The ID or slug of the narrative.

Example:

gaming

Query Params

cursor

string

optional

limit

integer

optional

>= 0<= 20

sort_by

enum<string>

optional

Allowed values:

market_capmindshare

Default:

mindshare

sort_order

enum<string>

optional

Allowed values:

ascdesc

Default:

desc

Header Params

authorization

string

optional

Default:

Bearer {{auth_token}}

Responses

🟢200Success

application/json

Successful retrieval of projects within the narrative.

Body

data

array [object {5}]

required

twitter_profile

object (Twitter Profile)

required

coin

object

required

mindshare

object

required

total_views

integer

required

total_posts

integer

required

pagination

object (Pagination Meta)

required

page

integer

required

Current page number

limit

integer

required

Number of items per page

cursor

string | null

required

Cursor for next page (null if no more pages)

🟠404Record not found

🟠400Invalid input

Modified at 2025-07-03 21:00:27

Get Narrative Details

Get Narrative Market Cap Chart