v1

latestOpenAPI 3.0.42026-07-26159287356.1 KB
Subscribers

Subscribed to

Fetch what FIDs and contracts a FID is subscribed to.

get/v2/farcaster/user/subscribed_to/

Query parameters

fidinteger required
Example:3

The unique identifier of a farcaster user or app (unsigned integer)

viewer_fidinteger
subscription_provider'fabric_stp' required

The provider of the subscription.

Response

Success

Example response

{
  "subscribed_to": [
    {
      "chain": 8453,
      "contract_address": "0xff63fc310d47ef80961056ac8df0b3f1a9e3ef58",
      "creator": {
        "auth_addresses": [
          {
            "address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
            "app": {
              "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
              "fid": 3
            }
          }
        ],
        "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
        "fid": 3,
        "profile": {
          "bio": {
            "mentioned_profiles": [
              {
                "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
                "fid": 3
              }
            ]
          }
        },
        "verifications": [
          "0x5a927ac639636e534b678e81768ca19e2c6280b7"
        ],
        "verified_addresses": {
          "eth_addresses": [
            "0x5a927ac639636e534b678e81768ca19e2c6280b7"
          ],
          "primary": {
            "eth_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7"
          }
        }
      },
      "expires_at": "2023-09-13T22:10:22.000Z",
      "metadata": {
        "art_url": "https://storage.withfabric.xyz/loom/403fdc10-95f3-4b25-9d77-5aac7ccb9fd1.jpg",
        "symbol": "MMS",
        "title": "/memes channel sub"
      },
      "owner_address": "0xb6f6dce6000ca88cc936b450cedb16a5c15f157f",
      "price": {
        "initial_mint_price": "0",
        "period_duration_seconds": 2592000,
        "tokens_per_period": "350574998400000"
      },
      "protocol_version": 1,
      "provider_name": "fabric_stp",
      "subscribed_at": "2023-09-13T22:10:22.000Z",
      "tier": {
        "id": 1,
        "price": {
          "initial_mint_price": "0",
          "period_duration_seconds": 2592000,
          "tokens_per_period": "3000000000000000"
        }
      },
      "tiers": [
        {
          "id": 1,
          "price": {
            "initial_mint_price": "0",
            "period_duration_seconds": 2592000,
            "tokens_per_period": "3000000000000000"
          }
        }
      ],
      "token": {
        "decimals": 18,
        "symbol": "ETH"
      }
    }
  ]
}