🎮API

Base URL: https://api.base-pass.xyz

Authentication

SIWE Flow

1

GET /api/auth/nonce → { nonce }

2

Sign message with wallet

3

POST /api/auth/login → sets HttpOnly cookie

4

All requests include cookie automatically

API Key

Creators

List Creators

GET /api/creators
GET /api/creators?search=alpha
GET /api/creators?category=Trading

Get Creator by Wallet

GET /api/creators/wallet/0x...

Update Profile

PUT /api/creators/wallet/0x.../profile
Cookie: basepass_token=...

{ "name": "...", "description": "...", "category": "Trading", ... }

All write endpoints require SIWE authentication and wallet ownership.

Update Discord Config

PUT /api/creators/wallet/0x.../discord
{ "discordGuildId": "123...", "discordRoleId": "456..." }

Update Telegram Config

PUT /api/creators/wallet/0x.../telegram
{ "telegramGroupId": "-100...", "telegramInviteLink": "https://t.me/+..." }

Subscriptions

Check Status

GET /api/subscriptions/status?wallet=0xSUB&creatorWallet=0xCREATOR

Response:

{ "active": true, "expiresAt": 1735689600, "remainingSeconds": 2592000 }

My Subscriptions

GET /api/subscriptions/mine/0xWALLET

Creator's Subscribers

GET /api/subscriptions/subscribers/0xCREATOR

Transaction History

GET /api/subscriptions/history/0xWALLET

Revenue Stats

GET /api/subscriptions/revenue/0xCREATOR

Token-Gated Access

Generate API Key

POST /api/keys
Cookie: basepass_token=...
{ "name": "My App" }

Response: { "key": "bp_live_...", "name": "My App", "prefix": "bp_live_abc1" }

Save the key immediately. It cannot be retrieved again.

Check Access

GET /api/gate/check?wallet=0xSUBSCRIBER
Authorization: Bearer bp_live_...

Response: { "hasAccess": true, "expiresAt": 1735689600 }

Telegram Linking

Generate Link Token

POST /api/telegram/generate-token
Cookie: basepass_token=...

Response: { "deepLink": "https://t.me/basepass_bot?start=...", "expiresIn": 600 }

Get Link Status

GET /api/telegram/wallet/0xWALLET
Cookie: basepass_token=...

Unlink

DELETE /api/telegram/unlink
Cookie: basepass_token=...
{ "walletAddress": "0x..." }

Utilities

Trigger Index Sync

POST /api/index/sync

Health Check

GET /health

Returns server status, indexer state, and blocks behind.