Badge

Overview of Badge API endpoints

The Badge API provides endpoints for managing game badges (ERC-721 tokens) in the system. These endpoints allow you to create, mint, transfer, burn, and query badge information.

Available Endpoints

Creation

Minting

Management

Queries

  • Get Badge Balance - Get badge balance for an address

  • List Badges - List badges owned by an address

  • Get Badge Info - Get detailed information about a badge

  • Get Badge Count - Get total count of badges

  • Get Badge by ID - Get badge information by ID

  • Get Badge Owner - Get the owner of a badge

  • Check Badge Burn Status - Check if a badge is burnt

Authentication

All endpoints require HMAC authentication using the hmacAuth('user') middleware. Make sure to include the following headers in your requests:

  • apikey: Your API key

  • signature: HMAC signature

  • timestamp: Current timestamp

Chain ID

Most endpoints require a chain ID to be specified. This can be done either in the request body or through the checkChainId middleware.

Last updated