API & Developer Reference

The ROBINDUDES Backend-for-Frontend (BFF) exposes read-optimized REST and real-time WebSocket endpoints. State-modifying on-chain transactions (minting, entering tiers, rerolling) are signed directly by user wallets via EVM RPCs.

1. Public REST API Endpoints

1. Schedule & Competitions

GET/api/schedule

Returns the current on-chain epoch schedule and active countdown timers.

{
  "epochStart": 1723456800,
  "epochDuration": 604800,
  "currentEpochId": 12,
  "currentEpochEndsAt": 1724061600,
  "timeRemainingSeconds": 142200
}

GET/api/competition/:weekId/leaderboard?tier=1

Retrieves live snapshot standings for the specified competition tier bracket.

{
  "weekId": 12,
  "tier": 1,
  "totalEntrants": 84,
  "leaderboard": [
    { "rank": 1, "tokenId": 142, "equity": 18420.50, "pnlPercent": 84.20, "tier": 1 },
    { "rank": 2, "tokenId": 871, "equity": 14120.00, "pnlPercent": 41.20, "tier": 1 },
    { "rank": 3, "tokenId": 339, "equity": 12970.25, "pnlPercent": 29.70, "tier": 1 }
  ]
}

GET/api/competition/:weekId/results

Returns settled winners, audited resultsHash, and on-chain transaction references.

{
  "weekId": 11,
  "isSettled": true,
  "resultsHash": "0x4f8a...c129",
  "resultsURI": "ipfs://QmZ4...78a",
  "payouts": [
    { "tier": 1, "rank": 1, "tokenId": 142, "payoutDudes": "400.0" },
    { "tier": 1, "rank": 2, "tokenId": 871, "payoutDudes": "300.0" },
    { "tier": 1, "rank": 3, "tokenId": 339, "payoutDudes": "200.0" }
  ]
}

2. NFT & Token Bound Accounts

GET/api/nft/:tokenId

Returns metadata, current on-chain skill levels, and TBA address.

{
  "tokenId": 142,
  "owner": "0x71C...32a",
  "rarity": "Epic",
  "tbaAddress": "0x892...51B",
  "isTbaDeployed": true,
  "skills": [
    { "skillId": 1, "name": "Signal Layer", "level": 3 },
    { "skillId": 2, "name": "Capital Boost", "level": 1 }
  ]
}

GET/api/reroll/:tokenId/pending

Checks if an outstanding reroll request exists and if targetBlock is ready for reveal.

{
  "tokenId": 142,
  "isPending": true,
  "targetBlock": 6421990,
  "currentBlock": 6421995,
  "canReveal": true
}

3. Alpha Engine Signals

GET/api/alpha/signal?asset=BTC

Genericized institutional smart money flow indicators (available for NFTs with Signal Layer skill).

{
  "asset": "BTC",
  "flowDirection": "ACCUMULATION",
  "signalStrength": "HIGH",
  "smartMoneyInflow24h": "+142.5M",
  "lastUpdated": 1723458000
}

2. Real-Time WebSocket Market Stream

Clients connect to wss://api.robindudes.com/market-stream for live price and candle subscriptions:

// Client Subscribe Message
{
  "action": "subscribe",
  "channels": ["prices:BTC-USD", "prices:ETH-USD", "candles:1m"]
}

// Server Broadcast Payload
{
  "channel": "prices:BTC-USD",
  "price": 64280.50,
  "bid": 64278.00,
  "ask": 64283.00,
  "timestamp": 1723458120
}

Next: Legal Terms & DisclaimersReview paper trading disclaimers, pari-mutuel notes, and experimental risk terms.

VIEW TERMS & CONDITIONS →