API & Pricing

Programmatic access to Solana narrative intelligence. No API keys, no signup — just fetch the endpoints. Pay-per-request bypass when you hit rate limits.

Pricing Tiers

Free Tier

- 30 requests/hr — reports & signals
- 60 requests/hr — search
- Per-IP rate limiting
- No signup required
- Full response data

Pay-per-Request

$0.01 USDC / request

- Unlimited when rate-limited
- Solana USDC micropayments
- No API keys needed
- x402 protocol
- Only triggers when free tier exhausted

API Endpoints

Base URL: https://solis.rectorspace.com

Endpoint	Method	Rate Limit	Description
/api/reports	GET	30/hr	All report summaries
/api/reports?date=YYYY-MM-DD	GET	30/hr	Full report by date
/api/signals?date=YYYY-MM-DD	GET	30/hr	Raw signal data by date
/api/search	GET	60/hr	All narratives (flat list)

Response Examples

GET /api/reports — Report Summaries

{
  "date": "2026-02-12",
  "generatedAt": "2026-02-12T08:12:34.567Z",
  "period": { "start": "2026-01-29", "end": "2026-02-12" },
  "narrativeCount": 8,
  "topNarratives": [
    { "name": "Solana DePIN Expansion", "stage": "GROWING", "momentum": "accelerating" },
    { "name": "ZK Compression Tooling", "stage": "EARLY", "momentum": "stable" }
  ],
  "buildIdeaCount": 12
}

GET /api/reports?date=2026-02-12 — Full Report

{
  "version": "1.0",
  "generatedAt": "2026-02-12T08:12:34.567Z",
  "period": { "start": "2026-01-29", "end": "2026-02-12" },
  "narratives": [ ... ],
  "buildIdeas": [ ... ],
  "signals": { "leading": ..., "coincident": ..., "confirming": ... },
  "diff": { "newNarratives": [...], "stageTransitions": [...] },
  "meta": { "narrativesIdentified": 8, "anomaliesDetected": 14 }
}

GET /api/signals?date=2026-02-12 — Raw Signals

{
  "date": "2026-02-12",
  "signals": {
    "leading": { "repos": [...], "anomalies": [...], "newRepoClusters": [...] },
    "coincident": { "tvl": { "total": 8234000000, ... }, "onchain": [...] },
    "confirming": { "tokens": [...], "trending": [...] }
  }
}

GET /api/search — All Narratives

[
  {
    "name": "Solana DePIN Expansion",
    "stage": "GROWING",
    "momentum": "accelerating",
    "confidence": 82,
    "date": "2026-02-12",
    "relatedTokens": ["HNT", "MOBILE", "IOT"]
  },
  ...
]

Rate Limit Headers

Every response includes rate limit headers so you can track your usage:

Header	Description
X-RateLimit-Limit	Maximum requests per window
X-RateLimit-Remaining	Requests remaining in current window
X-RateLimit-Reset	Unix timestamp (seconds) when window resets

x402 Payment Flow

When your free tier is exhausted, the API returns a 402 Payment Required response with payment details. The x402 protocol enables trustless micropayments — no accounts, no subscriptions.

Normal Request

Send a GET request to any API endpoint. If within rate limits, you get the response immediately.

402 Response

Rate limit exceeded. Response body contains payment details: amount (USDC), recipient address, network (solana-mainnet), and USDC mint address.

Sign USDC Transfer

Client signs a Solana USDC transfer for the specified amount using their wallet.

Retry with Payment

Retry the original request with the payment proof in the x-payment header (base64-encoded JSON).

Verified Access

Server verifies payment via the x402 facilitator. If valid, the rate limit is bypassed and data is returned.

Integration Example

Illustrative TypeScript example. See x402.org for full client SDK implementation.

const res = await fetch('https://solis.rectorspace.com/api/reports');

if (res.status === 402) {
  // Free tier exhausted — x402 payment required
  const { accepts } = await res.json();
  const paymentDetails = accepts[0];

  // Sign USDC transfer using your Solana wallet
  // See x402.org for full client implementation
  const proof = await signPayment(paymentDetails);

  // Retry with payment proof
  const paid = await fetch('https://solis.rectorspace.com/api/reports', {
    headers: { 'x-payment': btoa(JSON.stringify(proof)) }
  });
  const data = await paid.json();
}

Notes

No API Keys

Zero signup, zero configuration. Just fetch the endpoints.

Per-Request Pricing

No subscriptions, no commitments. Pay only when you exceed the free tier.

Solana USDC Only

Payments on Solana mainnet using USDC (SPL token). Sub-cent transaction fees.

Open Source

Full source on GitHub. Self-host your own instance if you prefer.