x40docs — docs for x402 paid APIs and x403 Harbinger notify  |  Our sites: x402 Marketplace · Smithery migration · grokzilla.shop · Harbinger app · Harbinger docs

x403 quickstart

# Discovery (free)
curl https://www.x403-harbinger.com/.well-known/harbinger
# Watches and prices (free)
curl https://www.x403-harbinger.com/v1/watches
# Free last prints
curl https://www.x403-harbinger.com/v1/tape
# The challenge
curl -i https://www.x403-harbinger.com/v1/stream -H 'X-Harbinger-Watch: w_btc_10_1h'
# HTTP/2 403
# x-harbinger-forbidden: grant-required
# x-harbinger-price: 0.22 USDC
# x-harbinger-advantage-window: 2400
# Then, after paying and signing:
curl -N https://www.x403-harbinger.com/v1/stream -H 'Accept: text/event-stream' \
  -H 'X-Harbinger-Watch: w_btc_10_1h' -H 'X-Harbinger-Grant: hp2.<tx>.<ts>.<sig>'

Never put grants in query strings, only in the header, and only over TLS.