Version: 1.0.0
Last Updated: 14/08/2025

Get started

API Endpoint

https://api-v1.shill-it.fun/

Shill It API - receive all needed data for the frontend.

Participants


API Endpoint

https://api-v1.shill-it.fun/api/participants

Get all registered participants: GET
https://api-v1.shill-it.fun/api/participants 



Result example :

{
    "data": [
        {
            "user_id": 1,
            "username": "Username",
            "x_profile_photo": "",
            "x_id": 11111,
            "followers": 111,
            "x_account_created": "1970-01-01 00:00:00",
            "is_bot": 0/1,
            "is_x_verified": 0/1
        }
    ]
}

Result

Field Type Description
user_id Integer internal user id
username String (max. 64 characters) X Username
username Text X profile photo
x_id Integer X User ID returned from API
followers Integer X followers for user account
x_account_created date format: Y-m-d H:i:s Date when x account was created
is_bot boolean Participant account is a flagged bot
is_x_verified boolean Participant has x premium / is x verified 

API Endpoint

https://api-v1.shill-it.fun/api/register-participant

Register a new participant: POST
https://api-v1.shill-it.fun/api/register-participant 



required data :

{
  "username": "Username",
  "x_id": 11111,
  "followers": 111,
  "x_account_created": "1970-01-01 00:00:00",
  "is_x_verified": 0/1
}

Required Data

Field Type Description
username String (max. 64 characters) X Username
x_id Integer X User ID returned from API
followers Integer X followers for user account
x_account_created date format: Y-m-d H:i:s Date when x account was created
is_x_verified boolean Participant has x premium / is x verified 

API Endpoint

https://api-v1.shill-it.fun/api/participant

Search for participant: POST
https://api-v1.shill-it.fun/api/participant
Search for specific participant either by username or x user id 



required data :

{
  "x_id": 11111
}

or

{
  "username": "username"
}

Required Data

Field Type Description
username String (max. 64 characters) X Username
x_id Integer X User ID returned from API 

API Endpoint

https://api-v1.shill-it.fun/api/getLeaderBoard

Get Participant Leaderboard (average score asc): GET
https://api-v1.shill-it.fun/api/getLeaderBoard
Returns the top 50 participants based on their average score throughout all participated campaigns 



Result :


{
    "data": [
        {
            "user_id": 1,
            "username": "Username",
            "x_id": 11111,
            "x_profile_photo": "",
            "followers": 1,
            "x_account_created": "1970-01-01 00:00:00",
            "is_bot": 0/1,
            "is_x_verified": 0/1,
        },
        ...
    ]
}

Result

Field Type Description
user_id Integer internal user id
username String (max. 64 characters) X Username
x_id Integer X User ID returned from API
followers Integer X followers for user account
x_account_created date format: Y-m-d H:i:s Date when x account was created
is_bot boolean Participant account is a flagged bot
is_x_verified boolean Participant has x premium / is x verified

Campaigns


API Endpoint

https://api-v1.shill-it.fun/api/get-campaigns

Get all currently active or upcoming campaigns: GET
https://api-v1.shill-it.fun/api/get-campaigns 



Result example :

{
    "data": [
        {
            "campaign_id": 1,
            "campaign_name": "Campaign Name",
            "campaign_description": "Campaign Description",
            "hash_tags": "",
            "contract_address": "",
            "chain": "",
            "project_owner": "",
            "total_rewards_pool": "0.00",
            "rewards_pool_currency": "",
            "participants": 0,
            "campaign_start": "1970-01-01 00:00:00",
            "campaign_end": "1970-01-01 00:00:00"
        }
    ]
}

Result

Field Type Description
campaign_id Integer internal campaign id
campaign_name String (max. 128 characters) Campaign Name / Token Name
campaign_description Text Campaign Description
hash_tags String (max. 255 characters) used Hashtags for campaign (space separated)
contract_address String (max. 52 characters) Contract address
chain String (max. 6 characters) Token chain (BSC, SOL, etc.)
project_owner String (max. 64 characters) X username of project owner
total_rewards_pool Decimal (Precision 2) Total amount prize pool
rewards_pool_currency String (max. 6 characters) Prize pool currency (USDT, USDC, BNB, SOL, ...)
participants Integer max amount participants
campaign_start date format: Y-m-d H:i:s Date and time when campaign starts
campaign_end date format: Y-m-d H:i:s Date and time when campaign ends 

API Endpoint

https://api-v1.shill-it.fun/api/save-campaign

Save a new campaign: POST
https://api-v1.shill-it.fun/api/save-campaign 



required data :

{
            "campaign_name": "Campaign Name",
            "campaign_description": "Campaign Description",
            "hash_tags": "",
            "contract_address": "",
            "chain": "",
            "project_owner": "",
            "total_rewards_pool": "0.00",
            "rewards_pool_currency": "",
            "participants": 1,
            "campaign_start": "1970-01-01 00:00:00",
            "campaign_end": "1970-01-01 00:00:00"
}

Required Data

Field Type Description
campaign_name String (min. 5 / max. 128 characters) Campaign Name / Token Name
campaign_description Text Campaign Description
hash_tags String (min. 5 / max. 255 characters) used Hashtags for campaign (space separated)
contract_address String (min. 32 / max. 52 characters) Contract address
chain String (min. 3 / max. 6 characters) Token chain (BSC, SOL, etc.)
project_owner String (min. 3 / max. 64 characters) X username of project owner
total_rewards_pool Decimal (Precision 2) Total amount prize pool
rewards_pool_currency String (max. 6 characters) Prize pool currency (USDT, USDC, BNB, SOL, ...)
participants Integer max. amount of participants
campaign_start date format: Y-m-d H:i:s Date and time when campaign starts
campaign_end date format: Y-m-d H:i:s Date and time when campaign ends