Wristband API
Query wristband NFT contract status, verify holder ownership, and retrieve token metadata. Wristbands are ERC-721 tokens on the Base network that grant access to premium features including HD live streams and token-gated channels.These endpoints do not require authentication. The wristband contract address is configured via the
WRISTBAND_CONTRACT_ADDRESS environment variable. When the contract is not configured, endpoints return a not_configured status instead of an error.Get contract info
Response (configured)
Response (not configured)
Verify holder
balanceOf function on the contract.
Query parameters
Response
When the contract is not configured:
Errors
On-chain read errors (for example, RPC failures) return a
200 response with hasWristband: false and an error field describing the failure, rather than an HTTP error status.Get token metadata
tokenURI base for the NFT contract.
Path parameters
Response
Metadata responses are cached for one hour via the
Cache-Control: public, max-age=3600 header.