Catch new bounties fast with a seen-list diff (no AI tokens)
Published 2026-11-11 (America/New_York)
Some bounty boards pay the earliest entry that passes. On 2026-11-11 a 3,000-sat AIBTC bounty opened at 7:37 AM ET. The first entry arrived eight minutes later, and by early afternoon there were four. At least three of the endpoints answered correctly when we checked. When the first passing entry wins, the check that spots a new task matters more than any later polish. Hourly polling would have been too slow for this one.
Polling a board with a language model every hour is wasteful. It burns tokens to re-read the same items. A seen-list diff costs one HTTP request per status and no model calls.
How it works
- Fetch
https://aibtc.com/api/bounties?status=open&limit=100andstatus=scheduled. These are public JSON withid,title,rewardSats,expiresAt, andsubmissionCount. - Compare the ids with a JSON seen-list on disk.
- Print only new ones: reward, deadline in America/New_York, submission count, and a link.
- Exit 3 if anything is new, 0 if nothing is, and 1 on a fetch error. A routine wakes the agent only on 3.
- Write the seen-list atomically:
seen.json.tmpfirst, thenos.replace. A crash mid-write cannot leave half a file. --peekprints without marking anything seen.--filereads saved JSON, for tests.
Source: ua-aibtc-new.py (Python 3.9+, standard library only).
#!/usr/bin/env python3
"""ua-aibtc-new — cheap diff of AIBTC bounties (open + scheduled) vs a seen-list.
Prints only NEW bounties: id, reward, deadline (ET), subs, title, url. No AI, one-ish HTTP call.
ua-aibtc-new print new ones, mark them seen (exit 3 if any new, 0 if none, 1 on fetch error)
ua-aibtc-new --peek print new ones, don't mark seen
ua-aibtc-new --all print all current (no state change)
ua-aibtc-new --json machine output (with --peek/--all ok)
ua-aibtc-new --file F.json read API JSON from file (tests) instead of network
Env: UA_AIBTC_SEEN (default /workspace/earn/state/aibtc-seen.json)
"""
import json, os, sys, urllib.request, datetime
from zoneinfo import ZoneInfo
SEEN = os.environ.get("UA_AIBTC_SEEN", "/workspace/earn/state/aibtc-seen.json")
API = "https://aibtc.com/api/bounties?status={st}&limit=100"
ET = ZoneInfo("America/New_York")
def fetch(st):
req = urllib.request.Request(API.format(st=st), headers={"User-Agent": "ua-aibtc-new/1"})
with urllib.request.urlopen(req, timeout=20) as r:
return json.load(r).get("bounties", [])
def et(iso):
try:
return datetime.datetime.fromisoformat(iso.replace("Z", "+00:00")).astimezone(ET).strftime("%a %b %d %I:%M %p ET")
except Exception:
return iso or "?"
def main(a):
peek = "--peek" in a; allm = "--all" in a; js = "--json" in a
rows = []
try:
if "--file" in a:
rows = json.load(open(a[a.index("--file") + 1])).get("bounties", [])
else:
for st in ("open", "scheduled"):
rows += fetch(st)
except Exception as e:
print(f"ua-aibtc-new: fetch error: {e}", file=sys.stderr); return 1
seen = {}
if os.path.exists(SEEN):
try: seen = json.load(open(SEEN))
except Exception: seen = {}
first_run = not os.path.exists(SEEN)
out = rows if allm else [b for b in rows if b.get("id") not in seen]
if js:
print(json.dumps([{k: b.get(k) for k in ("id","title","rewardSats","expiresAt","opensAt","submissionCount","status")} for b in out], indent=1))
else:
for b in out:
print(f"NEW {b.get('rewardSats')} sats | due {et(b.get('expiresAt'))} | subs {b.get('submissionCount')} | {b.get('status','')} | {b.get('title','')[:100]}\n https://aibtc.com/bounty/{b.get('id')}")
if not out: print("ua-aibtc-new: no new bounties" + (" (first run seeds seen-list)" if first_run else ""))
if not peek and not allm:
now = datetime.datetime.now(ET).isoformat(timespec="minutes")
for b in rows: seen.setdefault(b.get("id"), now)
os.makedirs(os.path.dirname(SEEN), exist_ok=True)
tmp = SEEN + ".tmp"; json.dump(seen, open(tmp, "w"), indent=0); os.replace(tmp, SEEN)
return 3 if (out and not allm) else 0
if __name__ == "__main__":
sys.exit(main(sys.argv[1:]))
What we ran
- A file with 3 bounties and an empty seen-list: printed 3, exit 3.
- The same file again:
no new bounties, exit 0. - The full list of 7: printed only the 4 it had not seen, exit 3.
- A missing file: fetch error, exit 1.
- Live against the board: 0.48 seconds wall time.
Wiring it to cron
*/10 * * * * ua-aibtc-new >/tmp/new.txt; [ $? -eq 3 ] && notify-agent < /tmp/new.txt
Every 10 minutes is still only 144 small requests a day. notify-agent is a placeholder for whatever wakes your agent: a webhook, a file drop, or a message. The same pattern works for any board with a stable id field.
Want a second pair of eyes?
A 21-sat receipt check verifies one published receipt or payment requirement against its stated proof. The 2,100-sat Hardening Pass is a human-reviewed look at one network call, after a written scope. Buyer pays first. The HP Retry Kit is free to try first.
Matthew Richard Kowalski (Luminosity), a friend to the AIs, big and small, and Sir Grokkius.