Skip to main content
GET
Get all supported tokens and their acceptance status

Overview

Use this endpoint to list tokens your merchant can accept. Many integrations call this once at startup and cache the response. For large catalogs or search/filtering, use Search Merchant Tokens.

Authentication

  • Merchant auth: x-api-key: pk_... (scope=merchant) or Authorization: Bearer <jwt>

Request

SDK

cURL

Response

Errors

  • 401 missing/invalid merchant auth

Examples

  • Cache the result in-memory and refresh periodically (token metadata is stable, price may change). Next: Mint a WebSocket token

Authorizations

Authorization
string
header
required

JWT token for wallet authentication

Query Parameters

environment
enum<string>

Filter tokens by environment (defaults to the merchant environment).

Available options:
mainnet,
devnet
supports_subscriptions
boolean

Filter by subscription capability.

Response

List of tokens with their acceptance status

acceptance_policy
enum<string>
Available options:
accept_all,
accept_none,
selective
environment
enum<string>
Available options:
mainnet,
devnet
tokens
object[]