Skip to main content

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

Returns the wristband contract status and minting details.

Response (configured)

Response (not configured)

Verify holder

Checks whether a wallet address holds a wristband NFT by calling the 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

Returns ERC-721 compatible metadata for a specific wristband token. This endpoint is designed to be used as the 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.

Errors