Build on Passiv.

Quickstart

Connect & sign in

Passiv uses Sign-In with Ethereum (EIP-4361). Your wallet must be on Base — the dashboard switches the network for you before requesting the signature. No funds move and no gas is spent; the signature only proves wallet ownership.

1. Connect wallet        → Base (chainId 8453)
2. Sign in with Ethereum → one signature, no gas
3. Session issued        → cohort resolved (k ≥ 50)

Query the API · x402

Agents pay per query with the x402 HTTP payment standard — the request carries a USDC micropayment header and settles on Base in ~200ms. Queries return cohort-level signal only: never an address, transaction hash, or raw amount.

# 1) unpaid request → 402 with payment requirements
curl -i -X POST https://oracle.passiv.finance/v1/query \
  -H "Content-Type: application/json" \
  -d '{ "traderType": "swing", "minMonthlyVolumeUsd": 10000 }'
# HTTP/1.1 402 Payment Required
# { "x402Version": 1, "accepts": [{ "scheme": "exact", "network": "base",
#   "asset": "0x8335…2913", "maxAmountRequired": "40000", "payTo": "0x…" }] }

# 2) retry with the signed X-PAYMENT header → 200
curl -X POST https://oracle.passiv.finance/v1/query \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <base64 x402 payload>" \
  -d '{ "traderType": "swing", "minMonthlyVolumeUsd": 10000 }'
# 200 OK — cohort-level only, never members/addresses
{ "cohortId": "swing-moderate", "k": 340, "suppressed": false,
  "profiles": [ { "volumeBucket": "10k-100k", "reactivity": "fast", … } ] }

TypeScript SDK

The SDK wraps the x402 handshake. You provide a payer (your USDC-on-Base wallet/facilitator) and call query() — it runs the 402 → pay → retry flow and enforces the k-anon floor numerically before returning.

import { createPassivClient } from "@passiv/sdk";

const passiv = createPassivClient({
  baseUrl: "https://oracle.passiv.finance",
  // wire an x402 wallet/facilitator (USDC on Base); returns the X-PAYMENT header
  payer: async (req) => payWithX402(req),
});

// 402 challenge → pay → retry is handled inside query()
const cohort = await passiv.query({ traderType: "swing", minMonthlyVolumeUsd: 10_000 });

console.log(cohort.cohortId, cohort.k); // "swing-moderate"  340

Earnings & payouts

The SDK above is the buyer (agent) side. As a wallet owner you don't run any code — you use the dashboard. Revenue splits 80% to wallet owners, 20% to the protocol, distributed across the cohort in proportion to each member's contribution. Balances accrue in USDC on Base and withdraw to your wallet once above the minimum.

Connect wallet  →  sign in (SIWE)  →  earnings accrue per query
Owner share        80%        (20% protocol)
Distribution       proportional across your cohort
Withdraw           USDC  →  your wallet on Base

Privacy & data controls

Preview status: the network currently runs on synthetic demo cohorts. Real wallet indexing, per-category enforcement, and revocation become active when the live data layer ships (see the whitepaper roadmap).

• Cohort-level only. Every response describes a group of ≥ 50 wallets — never an individual. Addresses and tx hashes are stripped before listing. (This k-anonymity floor is enforced server-side today.)
• You choose dimensions. Toggle the behavioral categories (trader type, risk, volume band, protocols, rhythm…) on or off from the dashboard.
• Revocation & deletion. Disconnect or disable categories from the dashboard; these controls become load-bearing on the live cohort network.

FAQ