GetFarcasterBidsReceived

API

API/v2/farcaster/get_bids_received

Title

GetFarcasterBidsReceived

Description

Retrieve the content created on Farcaster sent to you by others

Authorization

Not required

Method

POST

Request Parameters

NameTypeRequiredDescription

fids

int[]

YES

The Farcaster FID list of the curators

bidType

string[]

NO

"Casts", "Reply", "Recasts" If the bidType is not included in the request parameters, all data will be queried.

includeIgnore

bool

NO

Should ignored content be included. Default to true

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, OFFSET 5 means that the first 5 rows of the query result will be skipped.

sort

string

NO

Can sort by "bid_amount", "create_at", "update_at", default to "bid_amount"

sortType

string

NO

“desc” or “asc”, default to “desc”. Arrange in ascending or descending order.

state

string

NO

The state of bid. “Pending”, “Pass”, “Cancel”. If the state is not included in the request parameters, all data will be queried.

Parameter Content Type

application/json

Request and Response Example

Request

cURL Code

curl -X 'POST' \
  'https://api.tako.so/v2/farcaster/get_bids_received' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "fids": [
      15706
    ],
    "bidType": [
      "Casts", "Recasts", "Reply"
    ],
    "includeIgnore": true,
    "limit": 5,
    "offset": 0,
    "sort": "create_at",
    "sortType": "desc",
    "state": "Cancel"
  }'

Request URL

https://api.tako.so/v2/farcaster/get_bids_received

Response

{
  "status": "success",
  "data": {
    "count": 2,
    "data": [
      {
        "parent_hash": "0xb9887c91aa180ad3f2ff293ae29554068edf0d96",
        "to_curators": [
          15706
        ],
        "curator_fid": 0,
        "curator_hash": "                                          ",
        "id": 1742,
        "index": 21,
        "content_uri": "ar://SNb1k9zCEtHeGW-lsFYkNI014P7Xxm8tcL-wveltfvg",
        "bid_token": "0x0000000000000000000000000000000000000000",
        "bid_address": "0x4971EDC57A412E8Da8f0bA016bA2309bd99264f5",
        "bid_amount": "0",
        "bid_expires": 1694790029,
        "state": "Pending",
        "bid_type": "Reply",
        "block_number": 0,
        "others": {},
        "events": {
          "addBidEvent": {
            "state": "Pending",
            "tx_hash": "0xac7067dcb7f1515f10d6c47b63d30738d14740bd80bf1ab2ec5bb7daa7371787",
            "event_name": "addBidEvent",
            "block_number": 109574026,
            "block_timestamp": 1694746829
          }
        },
        "create_at": 1694746829,
        "update_at": 1694746829,
        "is_ignored": false
      },
      {
        "parent_hash": "0xde33643575401fb04caa9a60c5cccf0b37261880",
        "to_curators": [
          15706
        ],
        "curator_fid": 0,
        "curator_hash": "                                          ",
        "id": 560,
        "index": 9,
        "content_uri": "ar://iulWApzm7SUPUgmIG3TYcl0wOebr5N63_5nVfNKSmb4",
        "bid_token": "0x0000000000000000000000000000000000000000",
        "bid_address": "0x47Fcef6259d058BaB9389819E683A957ff89AD0a",
        "bid_amount": "0",
        "bid_expires": 1694638433,
        "state": "Pending",
        "bid_type": "Reply",
        "block_number": 0,
        "others": {},
        "events": {
          "addBidEvent": {
            "state": "Pending",
            "tx_hash": "0x52c6ab568b3f8d32fce04f8e82f778ac237a3f9c38e8a1f9e19e790b9df42fd0",
            "event_name": "addBidEvent",
            "block_number": 109498228,
            "block_timestamp": 1694595233
          }
        },
        "create_at": 1694595233,
        "update_at": 1694595233,
        "is_ignored": false
      }
    ],
    "ecosystem": "farcaster"
  }
}

Last updated