headers in notifications, recommended, discover

ethereumfollowprotocol · Mar 10, 2025 · 3eed9c6 · 3eed9c6
1 parent 8c697ee
commit 3eed9c6
Show file tree

Hide file tree

Showing 4 changed files with 46 additions and 26 deletions.
diff --git a/src/content/docs/api/Discover.mdx b/src/content/docs/api/Discover.mdx
@@ -19,31 +19,43 @@ curl https://api.ethfollow.xyz/api/v1/discover
 // sample response
 {
   "latestFollows": [
+    {
+      "address": "0xa8b4756959e1192042fc2a8a103dfe2bddf128e8",
+      "name": "caveman.eth",
+      "avatar": "https://euc.li/caveman.eth",
+      "header": "https://i.imgur.com/KYD6snF.jpeg",
+      "followers": "162",
+      "following": "482"
+    },
     {
       "address": "0x8513eef11bba6a57845d10780e7e889e3be289e8",
       "name": "oandrade.eth",
       "avatar": "https://metadata.ens.domains/mainnet/avatar/oandrade.eth",
+      "header": null,
       "followers": "5",
       "following": "15"
     },
     {
       "address": "0xb6518c8304992da58de9055f1db80a37609f00a2",
       "name": "silvr.eth",
       "avatar": "https://euc.li/silvr.eth",
+      "header": null,
       "followers": "1",
       "following": "0"
     },
     {
       "address": "0x8eddf5431f5b31933bfbd8111d54fc6e9456e6c1",
       "name": "slowsort.eth",
       "avatar": "https://euc.li/slowsort.eth",
+      "header": null,
       "followers": "49",
       "following": "565"
     },
     {
       "address": "0x4d982788c01402c4e0f657e1192d7736084ae5a8",
       "name": "garypalmerjr.eth",
       "avatar": "https://metadata.ens.domains/mainnet/avatar/garypalmerjr.eth",
+      "header": null,
       "followers": "152",
       "following": "3403"
     },

diff --git a/src/content/docs/api/Lists/recommended.mdx b/src/content/docs/api/Lists/recommended.mdx
@@ -24,25 +24,28 @@ curl https://api.ethfollow.xyz/api/v1/lists/1/recommended
 {
   "recommended": [
     {
-      "name": "usersteen.eth",
-      "address": "0x575c8a992ec082f3650432de77c1cbbccf568200",
-      "avatar": "https://euc.li/usersteen.eth",
+      "name": "swindler.eth",
+      "address": "0xf972bf8592c3171b378e97bb869a980c3f476583",
+      "avatar": "https://rainbow.mypinata.cloud/ipfs/QmcSAHrGGdXJRPmxYUk1R86Wqpfgg4TPMAXC6MfQHPugvF",
+      "header": "https://rainbow.mypinata.cloud/ipfs/QmVDbkDutSk4phVohMs76jV4RgT3bpSdzHnesBHFxW6jRL",
       "class": "B",
-      "created_at": "2024-09-18T17:10:24.406Z"
+      "created_at": "2025-03-07T15:53:58.797Z"
     },
     {
-      "name": "furyan.eth",
-      "address": "0x02a2295d86e530045844e25582185c65925b2eb8",
-      "avatar": "https://metadata.ens.domains/mainnet/avatar/furyan.eth",
+      "name": "gratefulape.eth",
+      "address": "0x52a4c418576dc46e4116ececc6f68d1c9b9636ed",
+      "avatar": "https://euc.li/gratefulape.eth",
+      "header": null,
       "class": "B",
-      "created_at": "2024-09-18T17:10:24.406Z"
+      "created_at": "2025-03-07T15:53:58.797Z"
     },
     {
-      "name": "shea.eth",
-      "address": "0x1b60a111d39b525cdd2c1669b0257cb00857b33b",
-      "avatar": "https://euc.li/shea.eth",
+      "name": "treeskulltown.eth",
+      "address": "0x2dacc0b072146b40e60b8596b99756112d45c924",
+      "avatar": "https://euc.li/treeskulltown.eth",
+      "header": null,
       "class": "B",
-      "created_at": "2024-09-18T17:10:24.406Z"
+      "created_at": "2025-03-07T15:53:58.797Z"
     },
     ...
   ]

diff --git a/src/content/docs/api/Users/notifications.mdx b/src/content/docs/api/Users/notifications.mdx
@@ -14,6 +14,7 @@ Get incoming actions received from other users by Address or ENS Name
 #### Query Parameters
 - `opcode` (number, optional): Specifies the type of operation to return [1 for follow, 2 for un-follow, 3 for tag, 4 for un-tag, 0 for any]  
 - `interval` (string, optional): Specifies the time range of notifications to return [hour, day, week, month, all].
+- `start` (number, optional): Specifies the starting timestamp to begin the interval, default value is now. [unix timestamp ex. 1741159543] 
 
 - `tag` (string, optional): Specifies a single tag string, of which each account in the response should have at least one.
 - `limit` (number, optional): Specifies the amount of records to return in the response. If not specifed, default value is 10.
@@ -25,6 +26,7 @@ Get incoming actions received from other users by Address or ENS Name
 A request to this endpoint with no query parameters specified will default to:
 - opcode = all 
 - interval = week
+- start = (current timestamp of now)
 - tag = ""
 - limit = 10
 - offset = 0

diff --git a/src/content/docs/api/Users/recommended.mdx b/src/content/docs/api/Users/recommended.mdx
@@ -24,25 +24,28 @@ curl https://api.ethfollow.xyz/api/v1/users/0xthrpw.eth/recommended
 {
   "recommended": [
     {
-      "name": "incarterseyes.eth",
-      "address": "0x5a084aaef5eddd9195f28f6fe056785e01f210eb",
-      "avatar": "https://arweave.net/pAMEFSMLuKfdBE4RX2HQd7l_TblPkqS8GIt7cOy8Bb0",
+      "name": "swindler.eth",
+      "address": "0xf972bf8592c3171b378e97bb869a980c3f476583",
+      "avatar": "https://rainbow.mypinata.cloud/ipfs/QmcSAHrGGdXJRPmxYUk1R86Wqpfgg4TPMAXC6MfQHPugvF",
+      "header": "https://rainbow.mypinata.cloud/ipfs/QmVDbkDutSk4phVohMs76jV4RgT3bpSdzHnesBHFxW6jRL",
       "class": "B",
-      "created_at": "2024-09-18T03:45:36.490Z"
+      "created_at": "2025-03-07T15:53:58.797Z"
     },
     {
-      "name": "occ.eth",
-      "address": "0x66d9640783719c13d6a106924000bc6153661a97",
-      "avatar": "https://euc.li/occ.eth",
-      "class": "C",
-      "created_at": "2024-09-18T03:45:36.490Z"
+      "name": "gratefulape.eth",
+      "address": "0x52a4c418576dc46e4116ececc6f68d1c9b9636ed",
+      "avatar": "https://euc.li/gratefulape.eth",
+      "header": null,
+      "class": "B",
+      "created_at": "2025-03-07T15:53:58.797Z"
     },
     {
-      "name": "aaronjmars.eth",
-      "address": "0x0000ce08fa224696a819877070bf378e8b131acf",
-      "avatar": "https://ens.xyz/aaronjmars.eth",
-      "class": "C",
-      "created_at": "2024-09-18T03:45:36.490Z"
+      "name": "treeskulltown.eth",
+      "address": "0x2dacc0b072146b40e60b8596b99756112d45c924",
+      "avatar": "https://euc.li/treeskulltown.eth",
+      "header": null,
+      "class": "B",
+      "created_at": "2025-03-07T15:53:58.797Z"
     },
 
     ...