HTTP API

$ curl -s https://pounty.co/api/tokens

{
  "chainId": 4663,
  "explorer": "https://robinhoodchain.blockscout.com",
  "tokens": [
    {
      "id": "ETH",
      "address": null,
      "symbol": "ETH",
      "name": "Ether",
      "decimals": 18,
      "kind": "native",
      "priceUsd": 2484.03,
      "imageUrl": "https://dd.dexscreener.com/ds-data/tokens/robinhood/0x0Bd7...d168.png?size=lg"
    },
    {
      "id": "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168",
      "address": "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168",
      "symbol": "USDG",
      "name": "Global Dollar",
      "decimals": 6,
      "kind": "stablecoin",
      "priceUsd": 1.0012
    },
    {
      "id": "0xaF3D76f1834A1d425780943C99Ea8A608f8a93f9",
      "address": "0xaF3D76f1834A1d425780943C99Ea8A608f8a93f9",
      "symbol": "AAPL",
      "name": "Apple • Robinhood Token",
      "decimals": 18,
      "kind": "stock",
      "priceUsd": 320.44
    }
  ]
}

$ curl -s https://pounty.co/api/eth-price
{"price":2484.03,"cached":false,"source":"coingecko","stale":false}

$ curl -s https://pounty.co/api/upload
{"enabled":false}

$ curl -s https://pounty.co/api/health
{"status":"ok","timestamp":"2026-09-07T23:27:31.341Z","service":"pounty-api",
 "services":{"database":{"status":"connected","error":null},
             "redis":{"status":"connected","error":null}}}

$ curl -s https://pounty.co/api/stats
{"totalPaidUsd":0,"daresCompleted":0,"activeDares":0,"payouts":[],"dares":[],
 "updatedAt":"2026-09-07T23:27:32.089Z"}

"auction": {
  "type": "dutch",
  "startAmount": "4",
  "maxAmount": "10",
  "hours": 1,
  "endsAt": "<funding + hours>",
  "closedAt": null,
  "minStepBps": null,
  "phase": "rising",          // pending | rising | at_max (Dutch) | bidding | open (English) | locked
  "currentReward": "7",       // Dutch price now, English lowest bid (or max), or the locked reward
  "currentRewardRaw": "7000000",
  "locked": null,             // { reward, userId, username, at } once a hunter holds it
  "bidCount": 0,
  "lowestBid": null,
  "maxNextBid": null,         // English while bidding: the most a new bid may be
  "surplusRefundTxHash": null // set after payout, when the unearned part went back to the creator
}

{
  "success": true,
  "dare": {
    "id": "<32 hex chars>",
    "title": "...",
    "rewardToken": "0xd0601CE157Db5bdC3162BbaC2a2C8aF5320D9EEC",
    "rewardSymbol": "NVDA",
    "rewardAmount": "2",
    "rewardAmountRaw": "2000000000000000000",
    "rewardUsd": 372.5,
    "status": "pending_payment",
    "escrowWalletAddress": "0x...",
    "refundAddress": "0x...",
    "expiresAt": "...",
    "payment": {
      "chainId": 4663,
      "address": "0x<escrow>",
      "token": "0xd0601CE157Db5bdC3162BbaC2a2C8aF5320D9EEC",
      "symbol": "NVDA",
      "decimals": 18,
      "amount": "2",
      "amountRaw": "2000000000000000000",
      "uri": "ethereum:0xd060...9EEC@4663/transfer?address=0x<escrow>&uint256=2000000000000000000",
      "explorerUrl": "https://robinhoodchain.blockscout.com/address/0x<escrow>",
      "deadline": "<created_at + 1 hour>"
    }
  },
  "message": "Dare created, payment required"
}

$ curl -s https://pounty.co/api/auth/me
{"user":null}

$ curl -s -X POST -H 'content-type: application/json' -d '{}' \
    https://pounty.co/api/dares/create
{"error":"Not authenticated"}

$ curl -s -X POST https://pounty.co/api/admin/process-expired
{"error":"Unauthorized"}

$ curl -s -X POST -H 'Authorization: Bearer <ADMIN_CRON_KEY>' \
    https://pounty.co/api/admin/process-expired
{
  "success": true,
  "skipped": false,
  "message": "Processed 0 payments, 0 expired dares, 0 expired acceptances, 0 refunds (0 failed, 0 need manual refund)",
  "processed": { "payments": [], "expiredDares": [], "reopenedDares": [],
                 "refunds": [], "staleLocksReleased": [], "staleProcessingSubmissions": 0 },
  "processedPayments": 0,
  "processedDares": 0,
  "expiredAcceptances": 0,
  "refunded": 0,
  "refundsFailed": 0,
  "daresNeedingRefund": 0,
  "timestamp": "..."
}

$ curl -s -X POST -H 'Authorization: Bearer <ADMIN_CRON_KEY>' -H 'content-type: application/json' \
    -d '{"tweetId":"1965000000000000001","authorId":"12345","handle":"someone",
         "text":"@pountybot 2 NVDA for the best meme of $CHUMP in 24h"}' \
    https://pounty.co/api/x/mention
{
  "success": true,
  "tweetId": "1965000000000000001",
  "status": "created",
  "code": null,
  "detail": null,
  "dareId": "<32 hex chars>",
  "replyText": "@someone Bounty created: 2 NVDA for \"the best meme of $CHUMP\".\nFund it: send exactly 2 NVDA on Robinhood Chain (id 4663) to\n0x<escrow>\nOpen 1 day once funded.\nhttps://pounty.co/platform?dare=<id>",
  "dare": { "id": "<id>", "title": "the best meme of $CHUMP", "amount": "2", "symbol": "NVDA",
            "escrowAddress": "0x<escrow>", "url": "https://pounty.co/platform?dare=<id>", "durationHours": 24 }
}