{"openapi":"3.1.0","info":{"title":"Lens Protocol API","version":"1.0.0","description":"Live data from Lens Protocol, the decentralized social graph where accounts, posts and follows are owned on-chain by users rather than by a platform — read from the public Lens v3 GraphQL API, no key, nothing stored. The account endpoint resolves a Lens username (or wallet address) to its on-chain profile: display name, bio, picture and address. The stats endpoint returns that account's social graph — follower and following counts plus its post, comment, repost, quote and collect totals. The posts endpoint returns an account's recent publications, each with its text, timestamp and full engagement (reactions, comments, reposts, quotes, bookmarks, collects). The feed endpoint returns the latest posts across the entire network. Look up any Lens handle, read their reach and pull their content as structured JSON. This is the decentralized-social cut — Web3-native social data distinct from the centralized-platform social APIs and from the crypto price and market APIs in the catalogue.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/lensprotocol-api","description":"oanor gateway"}],"tags":[{"name":"Account"},{"name":"Stats"},{"name":"Posts"},{"name":"Feed"},{"name":"Meta"},{"name":"Accounts"},{"name":"Graph"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/account":{"get":{"operationId":"get_v1_account","tags":["Account"],"summary":"Profile by username or address","description":"","parameters":[{"name":"username","in":"query","required":false,"description":"Lens local name","schema":{"type":"string"},"example":"stani"},{"name":"address","in":"query","required":false,"description":"0x EVM address (alternative to username)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"bio":"Founder & CEO @Aave","name":"Stani","source":"Lens","address":"0xAd2c0BEAdE60fb9f7ec5C87bDE8e4c126145F6E7","picture":"https://ik.imagekit.io/lens/4f0b6ecae2682c22c38a3f1c12f70e386ec68638b1895e53c969fdc9853f7022_rHSuskh0J.webp","username":"stani"},"meta":{"timestamp":"2026-06-11T16:46:51.603Z","request_id":"f52b8a79-dd51-4130-a407-cb344b598620"},"status":"ok","message":"Account retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/stats":{"get":{"operationId":"get_v1_stats","tags":["Stats"],"summary":"Social graph and engagement totals","description":"","parameters":[{"name":"username","in":"query","required":false,"description":"Lens local name","schema":{"type":"string"},"example":"stani"},{"name":"address","in":"query","required":false,"description":"0x EVM address (alternative to username)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"posts":17343,"quotes":1269,"source":"Lens","address":"0xAd2c0BEAdE60fb9f7ec5C87bDE8e4c126145F6E7","reposts":133,"collects":21,"comments":10840,"followers":143358,"following":1332},"meta":{"timestamp":"2026-06-11T16:46:51.952Z","request_id":"0e309bcc-12e1-4641-b65a-b114777ef323"},"status":"ok","message":"Stats retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/posts":{"get":{"operationId":"get_v1_posts","tags":["Posts"],"summary":"An account recent publications","description":"","parameters":[{"name":"username","in":"query","required":false,"description":"Lens local name","schema":{"type":"string"},"example":"stani"},{"name":"address","in":"query","required":false,"description":"0x EVM address (alternative to username)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Page size toggle (10 or 50)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":6,"posts":[{"id":"29950997887843140573021045301319055276593649424928219241369640520524533185092","slug":"2tzzmjkdb1bc7s3ejjb","stats":{"quotes":0,"reposts":0,"collects":0,"comments":1,"bookmarks":0,"reactions":52},"author":"stani","content":"This.","timestamp":"2026-03-08T13:58:30+00:00"},{"id":"71153967134142495887013702481720695612124184760692583486582587835708945860998","slug":"1ednargze2rr7a3ba9q","stats":{"quotes":0,"reposts":51,"collects":0,"comments":2,"bookmarks":0,"reactions":84},"author":"stani","content":"Great read <https://thedailyeconomy.org/article/worries-spread-in-private-credit-markets/>","timestamp":"2026-03-08T13:55:39+00:00"},{"id":"47496854049018462343258314737062822125159621937272688213846688339180614893587","slug":"3bvg6gnpq1c1mgbkhhq","stats":{"quotes":0,"reposts":25,"collects":0,"comments":1,"bookmarks":0,"reactions":55},"author":"stani","content":"Interesting","timestamp":"2026-02-21T17:40:28+00:00"},{"id":"1150202324733808577168516841126871610511678429125533229118553087262612173040","slug":"xk20zene7ycbdy0jnv","stats":{"quotes":0,"reposts":0,"collects":0,"comments":0,"bookmarks":0,"reactions":0},"author":"stani","content":"Yum","timestamp":"2026-02-21T17:39:53+00:00"},{"id":"48969079710916654757057767863140472526111426433840022638626373823844469418835","slug":"2h01zexw0z2bwfv6yzf","stats":{"quotes":0,"reposts":0,"collects":0,"comments":0,"bookmarks":0,"reactions":0},"author":"stani","content":"I’m slowly moving to Signal too, too many DeFinthings still there, mainly groups","timestamp":"2026-02-08T20:24:49+00:00"},{"id":"31811153655855094178172105511228837215543516648337346880458923474114901901033","slug":"bwn69ewys1tgfq3025","stats":{"quotes":3,"reposts":37,"collects":0,"comments":5,"bookmarks":0,"reactions":77},"author":"stani","content":"Agents everywhere","timestamp":"2026-02-08T20:21:31+00:00"}],"source":"Lens","address":"0xAd2c0BEAdE60fb9f7ec5C87bDE8e4c126145F6E7"},"meta":{"timestamp":"2026-06-11T16:46:52.439Z","request_id":"7fe50129-aecb-42c7-8820-f3da6e890658"},"status":"ok","message":"Posts retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/feed":{"get":{"operationId":"get_v1_feed","tags":["Feed"],"summary":"Latest posts across the network","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Page size toggle (10 or 50)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":8,"posts":[{"id":"63322265431791020110275816466562167289067899352389208207094232838131129808821","slug":"y34feb50a0rjdxe0yg","stats":{"quotes":0,"reposts":0,"collects":0,"comments":0,"bookmarks":0,"reactions":0},"author":"pixelfoxy","content":"So beautiful😍","timestamp":"2026-06-11T16:45:49+00:00"},{"id":"87093133575795856322280799554161077116915550486209427148813416234824451824134","slug":"91275g6aqzzebzzp03","stats":{"quotes":0,"reposts":0,"collects":0,"comments":0,"bookmarks":0,"reactions":0},"author":"datartist","content":"I drew this in high school.","timestamp":"2026-06-11T16:38:51+00:00"},{"id":"91732038926986472279331982247074854558808289305014709528995405137283402430664","slug":"2d20mvyppk093611n12","stats":{"quotes":0,"reposts":0,"collects":0,"comments":0,"bookmarks":0,"reactions":0},"author":"bettercallzaal","content":"Zm \n\nZAO phone getting some upgrades.","timestamp":"2026-06-11T16:35:06+00:00"},{"id":"8806226851819603872483671945422271502313525026619804732803127201180955117797","slug":"2q8mhj0t67j29tmmraz","stats":{"quotes":0,"reposts":0,"collects":0,"comments":0,"bookmarks":0,"reactions":0},"author":"mahatmiarz","content":"https://orb.club/t/lens/gho","timestamp":"2026-06-11T16:29:26+00:00"},{"id":"29473328933555652235100887190443282377639755018550418946647544236466039065367","slug":"3fzwd19hw7rm75qpxf8","stats":{"quotes":0,"reposts":0,"collects":0,"comments":0,"bookmarks":0,"reactions":1},"author":"mahatmiarz","content":"https://orb.club/@mahatmiarz?sharedBy=mahatmiarz","timestamp":"2026-06-11T16:27:53+00:00"},{"id":"4550765043746292102897712998378385921818185278653888773784921440123400788510","slug":"106b88btmwnc88wxcgk","stats":{"quotes":0,"reposts":0,"collects":0,"comments":0,"bookmarks":0,"reactions":0},"author":"heynews","content":"📰 How 'algorithm' got its name from a 9th-century Persian mathematician\n\nSource: NPR\nhttps://www.npr.org/2026/06/11/nx-s1-5848013/algorithm-word-week-etymology","timestamp":"2026-06-11T16:25:05+00:00"},{"id":"88117543349760594843956510540166952513434628435113090467611146840282541920576","slug":"3xpp9v3b911dt8z82dx","stats":{"quotes":0,"reposts":0,"collects":1,"comments":0,"bookmarks":0,"reactions":1},"author":"mahatmiarz","content":"GM Lens People 🫵","timestamp":"2026-06-11T16:24:39+00:00"},{"id":"12600493556448616615463158116498157634714309935759193156772744271036945490560","slug":"3yjhkcdm8vqs7v17gzn","stats":{"quotes":0,"reposts":0,"collects":0,"comments":0,"bookmarks":0,"reactions":0},"author":"every1","content":"Good Evening","timestamp":"2026-06-11T16:24:20+00:00"}],"source":"Lens"},"meta":{"timestamp":"2026-06-11T16:46:52.654Z","request_id":"46fd3155-7a19-4235-93fd-7a8e3a1522b9"},"status":"ok","message":"Feed retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Identify an account by username=stani (a Lens local name) or address=0x...; stats and posts accept either. Engagement and graph counts are on-chain-backed live figures.","source":"Lens v3 GraphQL (api.lens.xyz/graphql, live)","service":"lensprotocol-api","endpoints":{"GET /v1/feed":"Latest posts across the whole Lens network (limit=10|50).","GET /v1/meta":"This document.","GET /v1/posts":"An account's recent publications with text, timestamp and engagement (username=stani, limit=10|50).","GET /v1/stats":"Social graph — follower/following counts and post/comment/repost/collect totals (username=stani).","GET /v1/account":"Profile by username or address — name, bio, picture, address (username=stani)."},"description":"Live data from Lens Protocol, the decentralized social graph where accounts, posts and follows are owned on-chain by users rather than a platform. The account endpoint resolves a Lens username or address to its profile (name, bio, picture, address); the stats endpoint returns the social graph (follower/following counts and post/comment/repost/collect totals); the posts endpoint returns an account's recent publications with text, timestamp and engagement; the feed endpoint returns the latest posts across the whole network. Live, no key, nothing stored. The decentralized-social cut — distinct from the centralized-platform social APIs and the crypto price/market APIs.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-11T16:46:52.863Z","request_id":"bec90733-2627-46bd-ad27-790249cf4b50"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/followers":{"get":{"operationId":"get_v1_followers","tags":["Graph"],"summary":"The accounts that follow this account","description":"","parameters":[{"name":"username","in":"query","required":false,"description":"Lens local name","schema":{"type":"string"},"example":"stani"},{"name":"address","in":"query","required":false,"description":"0x EVM address (alternative to username)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Page size toggle (10 or 50)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"source":"Lens","address":"0xAd2c0BEAdE60fb9f7ec5C87bDE8e4c126145F6E7","followers":[{"name":"Debbie Soon","address":"0x3BA79A3C0D01ef03cdE07016259EbCA4BB075E68","picture":"https://gw.ipfs-lens.dev/ipfs/QmXn7Nw6pFguGszm7nSvzBKDgMvrT7ZoRxYF2C2e4FSsG1","username":"debsoon"},{"name":"fred riko","address":"0xAaBa522aADDb75D9a9EfF083e7138aa967aAc5db","picture":"https://gw.ipfs-lens.dev/ipfs/QmVA7235LqGiASsXFdg3wqT9zVdEcUtSsaHatgHKZuMTVY","username":"fredriko"},{"name":"dankshard","address":"0x9fAFA610D40c35fA68260D75eF1B805D1c2E0229","picture":"https://ik.imagekit.io/lens/243099fccab2df4723209af875e66f6b1e9bc629a21e228b451526a96494c4f5_puw06YV6D.jpeg","username":"dankshard"},{"name":"Jouni","address":"0xdB49CA48058680B2DeD6c44E65DEe912b3d7Fa4d","picture":"https://ik.imagekit.io/lens/a7838f0d410dae11e904f4e7e56e37c113774a61ff2faaf8f58238f34e18b548_cxbhLoELkT.png","username":"jouni"},{"name":"lol","address":"0x798E04BE7cf63E7b291Ff7E2294331f26c64B888","picture":"https://ik.imagekit.io/lens/131d8578c9ca130b6b2f80a22115532369d052b15aa7c3fda9edd789d50e34c3_F9JdfhcSp.webp","username":"lol"},{"name":"Cristina Spinei","address":"0x1b36adf13A18e3f97174A6fdeEc934c45a7cad03","picture":"https://gw.ipfs-lens.dev/ipfs/QmcQJM46JEe56ppAcAkd7uHNp1aCyiiBJGbNrJCQN1MobB","username":"cristinaspinei"},{"name":"ellie","address":"0xc592180DDeBA3F2EB3e4Ff3CD27Ea989752Ce63d","picture":"https://gw.ipfs-lens.dev/ipfs/bafybeibqmlop5kzh4whp64njtlf3brvhugb4v5sqyzgxnhaok3jnex4k4y","username":"elliepritts"},{"name":"˗ˏˋ Shavonne Wong ˎˊ˗ ✨ ◱ ◱","address":"0x1bA9b99E878f99151FfcbB4cC9065A81027474B7","username":"shavonnewong_"},{"name":"Random Potential","address":"0xaAd118e88CC813b9915243db41909A2ee4559300","picture":"https://ik.imagekit.io/lens/0771849ec54ec4c921ba54bc9c4ae27a42dc40abbb8fdd2299ba9d102d245b5b_k98P76uQF.webp","username":"potential"},{"name":"Refraction ᛥ IRL","address":"0x8F7274230453Dc938C46d4C467AE10732Df43131","picture":"https://ik.imagekit.io/lens/b4b24e66e346e9b5fa0f673e786e1ae52f58582aa1e250d8b8dd3a7d83811823_JGVzyCLGj.jpeg","username":"refraction"}]},"meta":{"timestamp":"2026-06-13T13:55:58.332Z","request_id":"814caf5f-209a-4e40-a02a-68c93276f1cf"},"status":"ok","message":"Followers retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/following":{"get":{"operationId":"get_v1_following","tags":["Graph"],"summary":"The accounts this account follows","description":"","parameters":[{"name":"username","in":"query","required":false,"description":"Lens local name","schema":{"type":"string"},"example":"stani"},{"name":"address","in":"query","required":false,"description":"0x EVM address (alternative to username)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Page size toggle (10 or 50)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"source":"Lens","address":"0xAd2c0BEAdE60fb9f7ec5C87bDE8e4c126145F6E7","following":[{"name":"Artem Militonian","address":"0xCe812129DFc3177EA523f6A2721bb96877E68031","picture":"https://ik.imagekit.io/lens/16031b1200b3c154925d20a5b93a16bccc1a605977a5c6cfec18995564c3edd1_wArBsi9in3.webp","username":"artem"},{"name":"SOCLLY","address":"0x6c4AfE4B98a08aa330C4b7e7D53BB3F67d97f3C5","picture":"https://ik.imagekit.io/lens/0b7258ec7a1a76ef3ba8571456e7661fc5c99d8110b328f26c7e1666ab006ee3_ycStoJigHn.webp","username":"socllyofficial"},{"name":"meluhian","address":"0xC6eA25De1e9879A5FB761043D3dc15610f44CFd3","picture":"https://ik.imagekit.io/lens/01183d1d80c91ee076cb373caec9a8e91534dda55cccb0aed33b48e5e4b174a1_MMvMh6aNvn.jpeg","username":"meluhian"},{"name":"Lens AI","address":"0x667E98d41eC55B59D01E91819f2ea1A39311f261","picture":"https://ik.imagekit.io/lens/8e01b8cedf8086dd8a89ef32b207b817d44a4894429b36ac864d34f8d5c0eebb_M5EYEIJsT.webp","username":"lensaihelper"},{"name":"LensForum","address":"0xB0Aba4F15a2DdC08F1Bc953Bf0518d8f9ed3a68d","picture":"https://ik.imagekit.io/lens/a784a35cadfeedede1c28b819575e36fea115eb8dd59ec87ea890788b4f7cc98_VRyahok2W.png","username":"lensforum"},{"name":"0Kelvin","address":"0xFf71D38a47e753FE81A4be8Fd48b8Aa556c6640d","picture":"https://gw.ipfs-lens.dev/ipfs/bafybeiaimclvqsvs5djornqhvr5ywuntzsahryquut4djyztfmnooqtpey","username":"91811"},{"name":"beantny","address":"0x7997a8834c4B853eB3E72B87Fd1F027059CAD324","picture":"https://ik.imagekit.io/lens/e950c39a884fa94a4d7ff9fd35d6dbcc7fabb2192e005ab505fe95e67b698167_XybN3BzeD.webp","username":"beantny"},{"name":"ciefa.eth","address":"0x398480445C7397EeAC6AC8453dCbaf529faDcC8B","picture":"https://ik.imagekit.io/lens/6fc39be1acae0ebcc09a5e077febffba1ab1dcf0a40b9b531f019d5723df2a96_WjUUrGXRj.webp","username":"ciefa"},{"name":"Lora AI","address":"0x00285163100EEE8F080C0f8A1DC397771B8C8ed6","picture":"https://ik.imagekit.io/lens/1eb076737b2db22059e53a91b21f802054f8da723d5caca2f3112d43c477e05d_YgLYNizf0.webp","username":"onlora"},{"name":"RegenSwap","address":"0x055346b827315D8fB7a3b583402ad369390f137B","picture":"https://ik.imagekit.io/lens/5562aed1c804633d9a888b9d0493b0de406f2ac645b4892cc1b927d9e4bb39ed_VjKySuwph.webp","username":"regenswap"}]},"meta":{"timestamp":"2026-06-13T13:55:58.648Z","request_id":"203efb9f-042c-4706-bd70-f9729ae4a37a"},"status":"ok","message":"Following retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":25000,"rps_limit":3,"hard_limit":true},{"slug":"creator","name":"Creator","price_cents_month":720,"monthly_call_quota":280000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2150,"monthly_call_quota":1150000,"rps_limit":28,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":4980,"monthly_call_quota":3900000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/lensprotocol-api"}