friend.tech API deep-dive

This is a brief deep-dive on the friend.tech frontend/API that aims to list out all the available endpoints that I have found so far. I'm not affiliated with the project in any way, I just like to poke around and see what I can find.

I hope this is useful to people trying to learn more about friend.tech or building on top of it. I'll keep updating the list as I find more endpoints and if you would like to contribute, please open an issue/PR.

The root API URL is https://prod-api.kosetto.com.

API Demo Client

Check out the /api-demo-client folder to host a demo client that allows you to more interactively fetch data from the friendtech API. Kudos to BankkRoll for building the demo client.

Endpoints

User

Get details about a user by address.

URL : /users/[ADDRESS]

Method : GET

Auth required : Yes

Response example

{
    "id": 903,
    "address": "0x4e5f7e4a774bd30b9bdca7eb84ce3681a71676e1",
    "twitterUsername": "cobie",
    "twitterName": "Cobie",
    "twitterPfpUrl": "https://pbs.twimg.com/profile_images/1688496375707701248/WwWz33DI.jpg",
    "twitterUserId": "2259434528",
    "lastOnline": 1691761722180,
    "holderCount": 158,
    "holdingCount": 17,
    "shareSupply": 197,
    "displayPrice": "2328062500000000000",
    "lifetimeFeesCollectedInWei": "0"
}

Holdings Activity

Gets a history of trades for a user.

URL : /holdings-activity/[ADDRESS]

Method : GET

Auth required : No

Response example

{
    {
     "events": [
        {
            "trader": {
            "address": "0xb9e7fa5d61a8ba3aaf4d0db02a34039fd6554d37",
            "pfpUrl": "https://pbs.twimg.com/profile_images/1612810393876930564/7toyk7Rp.jpg",
            "username": "hero_truck",
            "name": "𝙷𝚎𝚛𝚘 𝚃𝚛𝚞𝚌𝚔 🚚"
            },
            "subject": {
            "address": "0x3784bb094b17aab289872322dcb41aa675bafa74",
            "pfpUrl": "https://pbs.twimg.com/profile_images/1692694978969907200/LNuVZYWj.jpg",
            "username": "garrytan",
            "name": "Garry Tantacles 陈嘉兴 🛡️— e/acc"
            },
            "isBuy": false,
            "shareAmount": "1",
            "ethAmount": "517562500000000000",
            "createdAt": 1692651959442
        },
    ],
    "nextPageStart": 0
    }
}

Friends Activity

Gets a history of friends-related activity for a user.

URL : /friends-activity/[ADDRESS]

Method : GET

Auth required : No

Response example

{
    {
     "events": [
        {
           "trader": {
            "address": "0x3c3985a23f12fac7023d134f8b4c131947ae1279",
            "pfpUrl": "https://pbs.twimg.com/profile_images/1611158476239036420/ih4HPw_W.jpg",
            "username": "icebergy_",
            "name": "icebergy ❄️"
            },
            "subject": {
            "address": "0x9394516df4eaf9eaa559659c48d6fc2eaae16967",
            "pfpUrl": "https://pbs.twimg.com/profile_images/1683898245431296000/WgXztXiV.jpg",
            "username": "d0unbug",
            "name": "dounbug"
            },
            "isBuy": false,
            "shareAmount": "1",
            "ethAmount": "232562500000000000",
            "createdAt": 1692650867283
        },
    ],
    "nextPageStart": 0
    }
}

Portfolio

Gets a history of friends-related activity for a user.

URL : /portfolio/[ADDRESS]

Method : GET

Auth required : Yes

Response example

{
    "holdings": [
        {
            "pfpUrl": "https://pbs.twimg.com/profile_images/1687362497475465216/OPxBMpIw.png",
            "username": "abstractooor",
            "name": "konradkopp.eth",
            "subject": "0xf0b10ec1a5694b2b4305ae7b6d14c5d6024ac72c",
            "chatRoomId": "0xf0b10ec1a5694b2b4305ae7b6d14c5d6024ac72c",
            "price": "250000000000000",
            "balance": "1",
            "balanceEthValue": "250000000000000",
            "lastOnline": null,
            "lastMessageName": "...",
            "lastMessageTime": "1692689898270",
            "lastMessageText": "...",
            "lastRead": "1692632808671"
        }
    ],
    "portfolioValueWei": "250000000000000",
    "nextPageStart": 1000
}

Points

Gets the points for a user (potentially used for an airdrop).

URL : /points/[ADDRESS]

Method : GET

Auth required : No

Response example

{
    "address": "0x4e5f7e4a774bd30b9bdca7eb84ce3681a71676e1",
    "totalPoints": 104815,
    "tier": "DIAMOND"
}

Used code

Returns whether a user has used an invite code.

URL : /used-code

Method : GET

Auth required : Yes

Response example

{ "isAddressInvited": true }

Gating state

Returns whether a user is accepted (unknown what this entails - could be a way to blacklist users).

URL : /gating-state/[ADDRESS]

Method : GET

Auth required : Yes

Response example

{ "isAccepted": true }

Chatroom enabled

Returns whether a user has used an invite code.

URL : /notifications/chatRooms/[ADDRESS]

Method : GET

Auth required : No

Response example

{ "isEnabled": true }

Users by id

Gets a user by their id.

URL : /users/by-id/[ID]

Method : GET

Auth required : No

Response example

{
    "id": 260,
    "address": "0xc37fc40e16d50d287e9cd60fa5d6cbcf2d322afb",
    "twitterUsername": "xingGorilla",
    "twitterName": "xing",
    "twitterPfpUrl": "https://pbs.twimg.com/profile_images/1667533197998194688/wyCwlomw.jpg",
    "twitterUserId": "887084056516583424",
    "lastOnline": 1691755936186,
    "lifetimeFeesCollectedInWei": "0"
}

Search

Search users by their twitter handle.

URL : /search/users?username=[TWITTER_USERNAME]

Method : GET

Auth required : Yes (as of 21/08) (see below for retrieving your auth token)

Curl example

curl 'https://prod-api.kosetto.com/search/users?username=d' \
  -H 'Authorization: [AUTH_TOKEN]' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Referer: https://www.friend.tech/' \
  --compressed

Response example

{
    "users": [
        {
            "address": "0xcb7a5d0c1074cd79ec001290ddecada17c275045",
            "twitterUsername": "0xDCypher",
            "twitterName": "DC",
            "twitterPfpUrl": "https://pbs.twimg.com/profile_images/1670206316059537408/LhXGeWp9.jpg",
            "twitterUserId": "1389003409760600064"
        }
    ]
}

Events

Gets a history of the 200 most recent trades.

URL : /events

Method : GET

Auth required : No

Response example

{
    "events": [
        {
            "id": 40613,
            "blurredUrl": "https://mintcam.s3.us-east-1.amazonaws.com/next-s3-uploads/c13b1878-15ba-4cb6-bf67-913f102ade83/blurred.png",
            "isNSFW": false,
            "caption": null,
            "value": "0",
            "surplus": "0",
            "previousOwner": "0x9E876bC45B9efd1113823dB655A9e33c6dCfD5b4",
            "stealer": "0x9EA4039d038EF51C87774EC9197A3eD561A0Fb3F",
            "creator": "0x9E876bC45B9efd1113823dB655A9e33c6dCfD5b4",
            "previousOwnerPfpUrl": "https://pbs.twimg.com/profile_images/1652225412913586178/xF_r9KIW_normal.png",
            "previousOwnerUsername": "staszv08",
            "stealerPfpUrl": null,
            "stealerUsername": null,
            "creatorPfpUrl": "https://pbs.twimg.com/profile_images/1652225412913586178/xF_r9KIW_normal.png",
            "creatorUsername": "staszv08"
        }
    ]
}

Top list by price

Gets a list of users by their token price

URL : /lists/top-by-price

Method : GET

Auth required : No

Response example

{
    "users": [
        {
            "id": 11,
            "address": "0xfd7232e66a69e1ae01e1e0ea8fab4776e2d325a9",
            "twitterUsername": "0xRacerAlt",
            "twitterName": "Racer",
            "twitterPfpUrl": "https://pbs.twimg.com/profile_images/1688403387090673665/HOhwOdYd.jpg",
            "twitterUserId": "1455020265520435201",
            "lastOnline": 1691760917233,
            "displayPrice": "3025000000000000000",
            "holderCount": 149,
            "shareSupply": 219
        }
    ]
}

Trending

Gets a list of trending users

URL : /lists/trending

Method : GET

Auth required : No

Response example

{
    "users": [
        {
            "twitterUsername": "Christianeth",
            "twitterName": "Christian2022.mid",
            "twitterPfpUrl": "https://pbs.twimg.com/profile_images/1693173548796563456/Z6Qj2ETo_400x400.jpg",
            "lastOnline": 0,
            "displayPrice": "1580062500000000000",
            "volume": "27606875000000000000",
            "netBuy": "27606875000000000000"
        }
    ]
}

Bonus endpoints

Accounts

undetermined

URL : /accounts/[???]

Method : GET

Auth required : No

Response example

undetermined

Error Response example

{ "message": "No account" }

Kosetto config

Gets the contract config previously used for the Kosetto NFT (rugged).

URL : /config

Method : GET

Auth required : No

Response example

{
    "minAppVersionIOS": "1.0.0",
    "minAppVersionAndroid": "1.0.0",
    "gachaCost": 700,
    "network": "ethereum",
    "contractAddress": "0x4822d507d32b520a217183ae4344e0cece873599",
    "gachaLaunchMs": 1674282060000
}

Getting the auth token

1. Open the friend.tech website on your browser
2. Open the developer tools
3. Go to the application tab
4. Under the storage section, click on the Local Storage dropdown and find the friend.tech entry
5. Copy the value of the jwt key

Alternatively, follow this guide to create a new Privy wallet and extract the JWT from it.

Error codes

When hitting an unknown API endpoint, the following error is returned instead of the standard 404. Seeing this error does not mean a lack of access but that an unkown route is hit:

Unauthorized

Pagination

Unclear so far how pagination works. Using the common query params ?start=, ?page= and ?p= doesn't seem to work.