# AirdropPulse

> Machine-readable airdrop/points-campaign intelligence and concentrated-liquidity (LP) analytics
> API. First and only analytics coverage of the GigaDex points campaign on Robinhood Chain
> (chain id 4663) — pool rankings, campaign clock, position audits, entry mechanics, LP range
> modeling, impermanent-loss forecasting, position health and rebalance comparisons. All via
> x402 micropayments (USDC on Base, plus additional networks). Agent-first: no API keys, no
> accounts, pay-per-call.

## What This Is

AirdropPulse is a pay-per-query API that reads the open GigaDex indexer (edge.gigadex.fi) and
raw Robinhood Chain RPC directly to compute deterministic airdrop/points and LP analytics. There
is no other analytics product covering this campaign. Every endpoint is a live computation, not
an LLM sample — identical inputs at the same block/indexer state return the same figures.

Two audiences: AI agents transacting via x402, and humans who know these opportunities exist
but need a clear read on the mechanics, the numbers, and the risks before participating.

## Payment

All endpoints require x402 micropayment (USDC on Base mainnet, additional networks supported
on most endpoints — see `/api/*` 402 response `accepts` array for the current list).
Protocol: x402 | Network: eip155:8453 (Base) | Asset: USDC

To use: send a GET request without a PAYMENT-SIGNATURE header to receive a 402 response with
payment requirements. Sign the payment and retry with the PAYMENT-SIGNATURE header.

## Endpoints

### Points & Airdrop Intel

GET /api/points/pool-ev?min_tvl_usd={1000}
- Returns: every eligible GigaDex pool ranked by historically observed campaign points earned
  per $1k of TVL per day — pools differ by 100x+ on this metric — with multiplier, TVL, volume
  and fee-APR context
- Price: $0.15

GET /api/points/campaign-status?giga_per_point={15}&fdv_usd={optional}
- Returns: campaign clock (status, days elapsed/left, farmer count, emission progress) plus a
  hypothetical implied-value-per-point scenario table across illustrative FDVs. giga_per_point
  is an UNOFFICIAL community-implied figure — GigaDex has not confirmed any redemption terms.
- Price: $0.05

GET /api/points/position-audit?token_id={id}  (or) ?account={0x…}
- Returns: points earned, share of campaign-wide emitted points, in-range status, and a
  trailing-rate projection to campaign end, for a single position NFT or every position under
  an account
- Price: $0.10

GET /api/points/entry-guide?min_tvl_usd={1000}
- Returns: campaign clock, the full eligible-pool table ranked by multiplier and TVL,
  deterministic on-chain participation mechanics (network, contracts, flow), and risk warnings
  (GIGA Protect anti-cycling rule, unaudited incentive contracts, unannounced redemption terms,
  the existing FAKE "GIGA" token to avoid)
- Price: $0.10

### LP Analytics

GET /api/lp/range-model?pool={0x…}&horizon_days={14}&lookback_hours={168}
- Returns: realized volatility from hourly on-chain price history, plus a width-scenario table —
  probability-in-range at horizon, expected time-in-range share, capital-efficiency multiple, and
  a naive fee-capture estimate — for candidate range widths
- Price: $0.25

GET /api/lp/il-forecast?pool={0x…}&lower_pct={15}&upper_pct={15}&horizon_days={14}
- Returns: exact impermanent-loss (CL-vs-HODL) value at a spread of hypothetical exit-price
  moves for a given range, plus a naive fee-capture estimate and prob-in-range over the horizon
- Price: $0.15

GET /api/lp/position-health?token_id={id}
- Returns: in-range status, % through band, distance to each range edge in price terms, pending
  fees and accrued points for a position NFT — the cheap monitoring poll, safe to call in a loop
- Price: $0.05

GET /api/lp/rebalance-check?token_id={id}&horizon_days={14}
- Returns: side-by-side scenario comparison of a position's current range vs. a same-width range
  recentered on the current price (prob-in-range, time-in-range share, capital efficiency), plus
  GIGA Protect / rebalance-cost considerations
- Price: $0.10

### Launchpad Provenance (LONG / Doppler)

GET /api/long/launch-check?token={0x…}
- Returns: one-call provenance verdict for a token address against the on-chain Doppler Airlock
  registry — registered LONG launch vs other launchpad vs imitator, whether the backing stock
  numeraire is an official Robinhood token, factory creator match, 1e18 vanity suffix and
  governance burn status
- Price: $0.05

GET /api/long/launch-feed?limit={20}&only_long={false}
- Returns: the most recent token launches on the Doppler Airlock (Robinhood Chain), decoded with
  the same provenance flags as launch-check — name/symbol, backing numeraire, integrator label,
  1e18 suffix — the new-pairs radar for the stock-paired memecoin market format
- Price: $0.10

GET /api/long/stock-backing?token={0x…}
- Returns: with a token — per-token stock-backing report for a LONG.xyz / Doppler launch:
  live price in stock and USD terms, FDV, sell-side depth extractable at -2/-5/-10/-25% price
  moves (stock and USD terms), cumulated pool fees, and the backing stock's share held in
  meme pools. Without a token — the aggregate table: share of each official Robinhood stock
  token's on-chain float held in the Uniswap v4 meme-pool singleton (headline example: ~40%
  of on-chain NVDA)
- Price: $0.15

## Why GigaDex / Robinhood Chain

GigaDex's points campaign on Robinhood Chain (chain id 4663) rewards liquidity providers with
campaign points, but pools differ by 100x+ in points-earned-per-dollar and the mechanics are
opaque. AirdropPulse is the only product ranking pools, modeling LP ranges, and auditing
positions for this campaign — deterministic, computed live, no LLM. AirdropPulse also covers
launchpad provenance for LONG.xyz and other Doppler-stack launchpads on Robinhood Chain —
meme/community tokens launched paired against Robinhood tokenized stocks (NVDA, GME, and more) —
verifying registry membership, integrator, and numeraire authenticity directly from the on-chain
Doppler Airlock.

## Compliance Disclaimer

AirdropPulse provides educational analytics computed from public on-chain data — historical
observations and model-based scenario estimates, not predictions, not investment advice, and
not a recommendation to enter, exit, or rebalance any position. AirdropPulse is non-custodial:
it never holds funds or private keys and never executes transactions. AirdropPulse is not
registered with or regulated by the SEC or any financial regulator. This disclaimer is appended
to every API response.

## Discovery

- OpenAPI spec: https://airdroppulse.theaslangroupllc.com/openapi.json
- Agent discovery: https://airdroppulse.theaslangroupllc.com/.well-known/agent.json

## Notes for AI Agents

- All endpoints return structured JSON with a `disclaimer` field appended automatically
- All figures are deterministic — computed live from the GigaDex indexer + on-chain RPC reads,
  no LLM anywhere in the response path
- No API key required — payment is the authentication
- Pool addresses can be discovered via /api/points/pool-ev or /api/points/entry-guide before
  calling any pool- or position-scoped endpoint