Skip to main content
GET
/
api
/
v1
/
merchant
/
tokens
/
search
List supported tokens with pagination and filters
curl --request GET \
  --url https://api-beta.pepay.io/api/v1/merchant/tokens/search \
  --header 'Authorization: Bearer <token>'
{
  "acceptance_policy": "accept_all",
  "environment": "mainnet",
  "total": 123,
  "limit": 123,
  "offset": 123,
  "tokens": [
    {
      "id": 123,
      "token_symbol": "<string>",
      "token_name": "<string>",
      "token_address": "<string>",
      "token_decimals": 123,
      "network": "<string>",
      "network_environment": "<string>",
      "token_type": "<string>",
      "requires_memo": true,
      "supports_stable_settlement": true,
      "is_active": true,
      "is_monitored": true,
      "is_blocked": true,
      "price": {
        "usd": 123,
        "last_updated_at": 123,
        "provider_type": "<string>"
      }
    }
  ]
}

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
limit
integer
default:50

Max number of tokens to return.

Required range: 1 <= x <= 200
offset
integer
default:0

Offset for pagination.

Required range: x >= 0

Search by token symbol, name, or address (case-insensitive).

network
enum<string>

Filter by network.

Available options:
ethereum,
base,
solana,
avalanche,
ton,
bsc,
arbitrum,
optimism,
cardano,
sui
token_type
enum<string>

Filter by token type.

Available options:
native,
erc20,
spl,
sui,
ton
is_active
boolean

Filter by active status.

supports_stable_settlement
boolean

Filter by stable settlement capability.

blocked
boolean

Filter by blocked status (selective policy only).

Response

Paginated token list

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