Get KOL Calls Overview

Tested

GET

/kols/{UsernameOrId}/calls-overview

Provides a general overview of a KOL's token calling history, including unique calls, best/worst performers, and most mentioned tokens.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://public-api.protokols.io/api/v1/kols//calls-overview' \
--header 'authorization: Bearer 99f0c8fbb6df52400c8edac910f9dbb3be93faea06ba928bba24011252409c4a'

Response Example

200 - Success

{
    "data": {
        "username": "Overdose_AI",
        "total_calls": 40,
        "total_calls_past_30_days": 3,
        "accuracy_rate_overall": 27.500000000000004,
        "accuracy_rate_past_30_days": 33.33333333333333,
        "average_roi_overall": 166.85306752294815,
        "average_support_days": 22.125,
        "most_called_narratives": [
            {
                "narrative": "Meme",
                "posts_count": 593,
                "domination_percent": 36.304640626913184
            },
            {
                "narrative": "AI",
                "posts_count": 320,
                "domination_percent": 19.59103710052651
            },
            {
                "narrative": "Layer 1",
                "posts_count": 259,
                "domination_percent": 15.856495653238643
            },
            {
                "narrative": "DePIN",
                "posts_count": 219,
                "domination_percent": 13.13823925554059
            },
            {
                "narrative": "DeFi",
                "posts_count": 163,
                "domination_percent": 5.558956777274397
            },
            {
                "narrative": "Metaverse",
                "posts_count": 85,
                "domination_percent": 5.203869229827355
            },
            {
                "narrative": "RWA",
                "posts_count": 45,
                "domination_percent": 2.3999020448144974
            },
            {
                "narrative": "InfoFi",
                "posts_count": 48,
                "domination_percent": 1.5427941716664626
            },
            {
                "narrative": "SocialFi",
                "posts_count": 11,
                "domination_percent": 0.40406514019835926
            }
        ],
        "best_call": {
            "token_name": "pepe",
            "token_symbol": "pepe",
            "date_of_call": "2023-04-20T16:02:25.000Z",
            "roi_achieved": 3662.4085345511426,
            "peak_roi_after_call": 10064.100321009437
        },
        "worst_call": {
            "token_name": "olivia",
            "token_symbol": "olivia",
            "date_of_call": "2025-06-06T15:25:31.000Z",
            "roi_achieved": -97.32296153728653,
            "peak_roi_after_call": 2.438670454892633
        }
    }
}

Request

Path Params

UsernameOrId

string

required

Header Params

authorization

string

optional

Default:

Bearer {{auth_token}}

Responses

🟢200Success

application/json

Successfully retrieved KOL calls overview.

Body

data

object (KOL Calls Overwiew)

required

username

string

required

total_calls

integer

required

total_calls_past_30_days

integer

required

accuracy_rate_overall

number

required

accuracy_rate_past_30_days

number

required

average_roi_overall

number

required

average_support_days

number

required

most_called_narratives

array [object {3}]

required

best_call

object

required

worst_call

object

required

🟠404Record not found

🟠400Invalid input

Modified at 2025-07-07 07:37:26

Get Posts Replies

Get KOL Coin Narratives Distribution