GetHoldersByAddress

API

API	/token/profile/v1/shares/holder/byaddr
Title	GetHoldersByAddress
Description	Get the Key holders by address that owns a Farcaster or Lens profile
Authorization	Not required
Method	GET

Request Parameters

Name	Type	Required	Description
ecosystem	string	YES	"lens" or "farcaster"
addr	string	YES	The user's EVM-wallet address
limit	int	NO	The number of bids displayed per page, default to 10
offset	int	NO	Specify the number of rows to be skipped from the beginning of the query result. For example, offsett 5 means that the first 5 rows of the query result will be skipped.

Request and Response Example

Request

cURL Code

curl -X 'GET' \
  'https://api.tako.so/token/profile/v1/shares/holder/byaddr?addr=0x765754CCDa2bfC41e8Fd399Fdd4C076fd79c5545&limit=10&ecosystem=farcaster' \
  -H 'accept: application/json'

Request URL

https://api.tako.so/token/profile/v1/shares/holder/byaddr?addr=0x765754CCDa2bfC41e8Fd399Fdd4C076fd79c5545&limit=10&ecosystem=farcaster

Response

{
  "code": 0,
  "msg": "OK",
  "data": {
    "shares": [
      {
        "trader": "0xE9162B421D272714613E7a528e7ED5Cd11fbC196",
        "trader_id": "10001",
        "content_id": "10001",
        "net_amount": 2,
        "price": "70833333333333",
        "fake_price": "",
        "real_price": "",
        "latest_trade_at": 0
      },
      {
        "trader": "0x575C05eAaE30FC659719AC81346076d2fC6C05A3",
        "trader_id": "10002",
        "content_id": "10001",
        "net_amount": 1,
        "price": "70833333333333",
        "fake_price": "",
        "real_price": "",
        "latest_trade_at": 0
      }
    ],
    "profiles": {
      "10001": {
        "fid": 10001,
        "username": "demo1",
        "displayName": "demo1",
        "pfp": {
          "url": "https://demo.com/demo1.jpg",
          "verified": false
        },
        "profile": {
          "bio": {
            "text": "",
            "mentions": []
          },
          "location": {
            "placeId": "",
            "description": ""
          }
        },
        "followerCount": 19,
        "followingCount": 9,
        "activeOnFcNetwork": false,
        "referrerUsername": "",
        "viewerContext": {
          "following": false,
          "followedBy": false,
          "canSendDirectCasts": true,
          "hasUploadedInboxKeys": true
        },
        "extras": {
          "fid": 10001,
          "custodyAddress": "0xE9162B421D272714613E7a528e7ED5Cd11fbC196"
        }
      },
      "10002": {
        "fid": 10002,
        "username": "demo2",
        "displayName": "demo2",
        "pfp": {
          "url": "https://demo.com/demo2.jpg",
          "verified": false
        },
        "profile": {
          "bio": {
            "text": "",
            "mentions": []
          },
          "location": {
            "placeId": "",
            "description": ""
          }
        },
        "followerCount": 14,
        "followingCount": 39,
        "activeOnFcNetwork": false,
        "referrerUsername": "",
        "viewerContext": {
          "following": false,
          "followedBy": false,
          "canSendDirectCasts": false,
          "hasUploadedInboxKeys": true
        },
        "extras": {
          "fid": 10002,
          "custodyAddress": "0x575C05eAaE30FC659719AC81346076d2fC6C05A3"
        }
      }
    },
    "link": {},
    "links": {},
    "members": {},
    "total": 2
  },
  "ts": "2023-12-21 13:00:46.59664"
}