{"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"}],"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 username (local name)","schema":{"type":"string"},"example":"stani"},{"name":"address","in":"query","required":false,"description":"Wallet address (0x...)","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 username","schema":{"type":"string"},"example":"stani"},{"name":"address","in":"query","required":false,"description":"Wallet address (0x...)","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 username","schema":{"type":"string"},"example":"stani"},{"name":"address","in":"query","required":false,"description":"Wallet address (0x...)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Page size 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 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"}}}}},"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"}