Links
🚦

API Capabilities

Learn all the current capabilities/features available on Airstack and its future roadmap.

Table Of Contents

Technology

  • ​Airstack indexes onchain and offchain data. Whenever possible we default to onchain as the source of truth.
  • Onchain data is indexed through a blend of technologies. New transactions from the chains and projects we index appear in Airstack within seconds of onchain finalization.
    • We index onchain data optimistically without waiting for block confirmation
    • If our indexing layer detects a reorg, then we will redo those blocks
  • Offchain data sources include Farcaster hubs, XMTP, and token/NFT Metadata.
  • Airstack’s data is uniquely organized to allow for composability, combining data from any of the Airstack data sources and APIs in a single query/response.
  • Airstack provides GraphQL APIs for the data, with the unique ability to query cross-chain, cross-project, and combine onchain and offchain data in a single query & response
  • Airstack AI engine writes GraphQL queries for the user, allowing for complex natural language queries such as “show me all attendees of @ethcc6 and their Lens profiles and if they have XMTP” or “show POAPs in common for stani.lens and betashop9.lens”
  • Abstractions. Airstack abstractions enable devs to easily integrate use cases not just data. The GUIDES in the left menu are designed to help you easily find abstractions that match your use cases.
  • Data is currently organized and stored in Airstack’s hosted infra, using Kafka, MongoDB, Postgres, Clickhouse, Redis, S3.
    • This allows for blazing fast queries with responses in milliseconds
    • We currently invest considerably to maintain and optimize this infra, so our clients don’t need to worry about it
    • In the future we plan to decentralize this and make it permissionless to access.
  • We download and store/resize all images and metadata in our CDN.
    • We do this for all NFT, POAPs (ipfs, arweave, etc). And also for any NFTs with audio or media files.
    • We offer 5 image sizes from our CDN that are easy to integrate in any app without further treatment
    • We also index and store all the NFT metadata, traits
    • Also all Farcaster, Lens, ENS profiles, images, bios

Rate Limits

We currently offer rate limit of 3000/min and burst of 300/second.

Features

This chart summarizes the major Abstractions, Features and Blockchains available in Airstack.

Please consults the tables below and the developer guides for granular details.
Airstack Web3 Integration
​

Blockchains, Tokens, and Dapps*

Feature
Ethereum
Polygon
Base
Gnosis POAP
Zora
OP
Offchain
ERC-20
✅
✅
✅
​
✅
​
Metadata
ERC-721
✅
✅
✅
​
✅
​
Resized images Metadata, housed in our CDN
ERC-1155
✅
✅
✅
​
✅
​
Resized images Metadata, housed in our CDN
ERC-6551
✅
✅
✅
​
✅
​
Resized images Metadata, housed in our CDN
Token Balances
✅
✅
✅
✅
✅
​
Resized images Metadata, housed in our CDN
Token Holders
✅
✅
✅
✅
✅
​
Resized images Metadata, housed in our CDN
Transfer History
✅
✅
✅
✅
✅
​
​
Mints
✅
✅
✅
✅
✅
​
​
Trending Mints
✅
✅
✅
​
✅
​
​
POAP
✅
​
​
✅
​
​
Resized images Metadata, housed in our CDN
Domains
ENS Primary All
​
​
​
​
​
Metadata Images
Lens Profiles, bios, images
​
✅
​
​
​
​
​
Lens Social Graph
​
✅
​
​
​
​
​
Farcaster Profiles, bios, images
​
​
​
​
​
✅
✅ Hubs
Farcaster social graph
​
​
​
​
​
​
✅ Hubs
XMTP
​
​
​
​
​
​
✅
Tokens in common, holders in common
✅
✅
✅
✅
✅
​
​
Rec Engines
✅
✅
✅
✅
✅
​
​
Spam filters
✅
✅
✅
✅
✅
​
​
Snapshot time series data
✅
✅
✅
✅
✅
​
​
Trending dapps
Q1 2024
Q1 2024
Q1 2024
Q1 2024
Q1 2024
​
​
Uniswap swaps
Q1 2024
Q1 2024
​
​
​
​
​
AI Natural language queries
✅
✅
✅
✅
✅
✅
✅
Webhooks
Q1 2024
Q1 2024
Q1 2024
Q1 2024
​
Q1 2024
Q1 2024
API for Airstack AI
Q1 2024
Q1 2024
Q1 2024
Q1 2024
​
Q1 2024
Q1 2024

Domains Specific

Feature
Availability
Fetch all ENS owned by a user (including subdomains)
​
✅
​
Fetch Primary ENS of a user
​
✅
​
Fetch ENS details (registration cost, expiry date, etc.)
​
✅
​
Resolve ENS address
​
✅
​
Resolve Namestone subdomain (ENS offchain)
​
✅
​
Resolve DNS Domain from ENS's DNS Registrar
​
✅
​
Resolve cb.id address
​
✅
​
ENS Profile images
​
✅
​
All POAPs owned by resolved ENS address
​
✅
​
ENS V2
​
✅
​

Lens Specific

Features
Availability
Lens Followers
​
✅
​
Lens Following
​
✅
​
Has XMTP
​
✅
​
Resolve Lens to 0x
​
✅
​
Resolve Lens to ENS
​
✅
​
Resolve Lens to Farcaster
​
✅
​
Has more than X Followers
​
✅
​
Followers More than X
​
✅
​
Mutually following
​
✅
​
Followers in Common
​
✅
​
More than X Followers in Common
​
✅
​
All POAPs of Lens User
​
✅
​
All Lens users who have POAP
​
✅
​
All tokens and NFTs of Lens User
​
✅
​
All Lens users who have tokens and NFTs
​
✅
​
Combo: Follows/following and has POAPs
​
✅
​
Combos: Follows/following and has Tokens
​
✅
​
Combos: Follows/following and has XMTP
​
✅
​
Also follows/following on Farcaster
​
✅
​
Date specific data (e.g. followed before/after date)
​
✅
​
Lens V2
​
✅
​
Lens Profile metadata: profile images, bio, etc.
​
✅
​
Lens Collects, combos thereof
Q1 2024
Mints by Lens users
✅
Trending Mints
✅
Lens users’ Contract Interactions
Q1 2024
Open Actions indexing
Q1 2024

Farcaster Specific

Features
Availability
Farcaster Followers
​
✅
​
Farcaster Following
​
✅
​
Has XMTP
​
✅
​
Resolve Farcaster to 0x
​
✅
​
Resolve Farcaster to ENS
​
✅
​
Resolve Farcaster to Lens
​
✅
​
Has more than X Followers
​
✅
​
Followers More than X
​
✅
​
Mutually following
​
✅
​
Followers in Common
​
✅
​
More than X Followers in Common
​
✅
​
All POAPs of Farcaster User
​
✅
​
All Farcaster users who have a POAP
​
✅
​
All tokens and NFTs of Farcaster User
​
✅
​
All Farcaster users who have tokens and NFTs
​
✅
​
Combo: Follows/following and has POAPs
​
✅
​
Combos: Follows/following and has Tokens
​
✅
​
Combos: Follows/following and has XMTP
​
✅
​
Also follows/following on Lens
​
✅
​
Date specific data (e.g. followed before/after date)
​
✅
​
Mints by Farcaster users
✅
Trending Mints
✅
Farcaster users’ Contract Interactions
Q1 2024

ERC-6551 Specific

Features
Availability
All ERC6551 accounts deployed
​
✅
​
ERC6551 accounts owned by users
​
✅
​
ERC6551 accounts of an NFT collection
​
✅
​
ENS & Lens of ERC6551 accounts (if any)
​
✅
​
Token Balances of ERC6551 accounts
​
✅
​
Traversing up ERC6551 tree
​
✅
​
Traversing down ERC6551 tree
​
✅
​
Cross-chain ERC6551 accounts (Ethereum & Polygon)
​
✅
​
Optimistic indexing/non-deployed ERC6551 accounts
​
✅
​
* all future release are subject to modification
Please contact us to let us know your needs.