Protokols
  1. Twitter Profiles
Protokols
  • Protokols API
  • Authentication
  • Rate Limits
  • Track Profiles
    • Track KOL Profile
      GET
    • Track Project Profile
      GET
  • Twitter Profiles
    • Get Profile
      GET
    • Get Profile by Contract Address
      GET
    • Get Profile Statistics
      GET
    • Get Profile Smart Engagement Posts
      GET
    • Get Profile Notable Followers
      GET
    • Get Profile Username History
      GET
    • Get Profile Followers Paginated
      GET
    • Get Profile Following Paginated
      GET
    • Search Profiles
      GET
  • Posts
    • Get Posts By ID
      GET
    • Search Posts
      GET
    • Get Post Retweets
      GET
    • Get Posts Replies
      GET
  • KOLs
    • Get KOL Calls Overview
      GET
    • Get KOL Coin Narratives Distribution
      GET
    • Get KOL Calls Market Cap Distribution
      GET
    • Get KOL Token Mentions
      GET
    • Get KOL Project Interactions
      GET
  • Projects
    • Get Project Top Influencers
      GET
    • Get Project Organic Posts Chart
      GET
    • Get Project Organic Views Chart
      GET
    • Get Project Mentioned Contract Addresses
      GET
    • Get Project AI Summary
      GET
  • Profile Charts
    • Get Profile Follower Chart
    • Get Profile Notable Follower Chart
    • Get Profile Smart Engagement Chart
    • Get Profile Views Chart
  • Narratives
    • List Narratives
    • Get Narrative Details
    • List Projects in Narrative
    • Get Narrative Market Cap Chart
    • Get Narrative Mindshare Chart
  • Webhooks
    • Get Webhook URLs
    • Add Webhook URL
    • Track Profile
  1. Twitter Profiles

Get Profile by Contract Address

Tested
GET
/profile/ca/{contract_address}
Retrieves comprehensive profile information by an associated contract address.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://public-api.protokols.io/api/v1/profile/ca/0xd888A5460fFFA4B14340DD9Fe2710cbABd520659' \
--header 'authorization: Bearer 99f0c8fbb6df52400c8edac910f9dbb3be93faea06ba928bba24011252409c4a'
Response Response Example
200 - Success
{
    "data": {
        "id": "1778866744138117122",
        "username": "Protokols_io",
        "avatar_url": "https://pbs.twimg.com/profile_images/1883537380843429888/PIbov1to_200x200.png",
        "description": "AI-powered platform that transforms complex data into clear, actionable insights.",
        "display_name": "ProtoKOLs",
        "followers_count": 15988,
        "lang": "",
        "following_count": 243,
        "is_verified": true,
        "profile_created_at": "2024-04-12T19:24:59.000Z",
        "description_link": null,
        "gold_badge": true,
        "smart_followers_count": 226,
        "kol_score": 2461
    }
}

Request

Path Params
contract_address
string 
required
The blockchain contract address associated with the KOL (e.g., primary wallet).
Example:
0xd888A5460fFFA4B14340DD9Fe2710cbABd520659
Header Params
authorization
string 
optional
Default:
Bearer {{auth_token}}

Responses

🟢200Success
application/json
Successful retrieval of KOL profile using contract address.
Body
data
object (Twitter Full Profile) 
required
id
string 
required
username
string 
required
avatar_url
string 
required
description
string 
required
display_name
string 
required
followers_count
integer 
required
lang
string 
required
following_count
integer 
required
is_verified
boolean 
required
profile_created_at
string 
required
description_link
string  | null 
optional
gold_badge
boolean  | null 
required
kol_score
number 
required
smart_followers_count
number 
required
🟠404Record not found
🟠400Invalid input
Modified at 2025-07-07 07:23:50
Previous
Get Profile
Next
Get Profile Statistics
Built with