Skip to main content
GET
/
api
/
v1
/
payments
/
available-tokens
List available payment tokens
curl --request GET \
  --url https://api-beta.pepay.io/api/v1/payments/available-tokens \
  --header 'x-session-token: <api-key>' \
  --header 'x-signature: <api-key>'
[
  {
    "id": 1,
    "token_symbol": "USDC",
    "token_name": "USDC",
    "token_type": "erc20",
    "network": "ethereum",
    "token_decimals": 6,
    "token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "requires_memo": false,
    "is_monitored": true,
    "has_settlement_route": true,
    "settlement_rate": 1.02,
    "settlement_cost_usd": 102,
    "is_same_token_settlement": false,
    "tier": "100",
    "tier_fee": 0,
    "availability_status": "AVAILABLE",
    "rate_updated_at": "2024-01-01T12:00:00Z"
  },
  {
    "id": 2,
    "token_symbol": "ETH",
    "token_name": "ETH",
    "token_type": "native",
    "network": "ethereum",
    "token_decimals": 18,
    "token_address": null,
    "requires_memo": false,
    "is_monitored": true,
    "has_settlement_route": false,
    "availability_status": "STALE",
    "rate_updated_at": "2024-01-01T11:50:00Z",
    "unavailable_reason": "Rate data is older than 5 minutes"
  }
]

Authorizations

​
x-session-token
string
header
required

Payment session token (opaque). Returned when creating an invoice; send on every request.

​
x-signature
string
header
required

Payment session signature in the format signature_hash.timestamp_ms (returned with the invoice/session).

Query Parameters

​
mode
enum<string>
default:monitored

Controls whether non-monitored tokens are included.

Available options:
monitored,
all,
network
​
network
enum<string>

Required when mode=network. Filters tokens to the given network (lowercase).

Available options:
ethereum,
base,
solana,
avalanche,
ton,
bsc,
arbitrum,
optimism,
cardano,
sui

Response

Token list

​
id
number

Token ID

​
token_symbol
string

Token ticker symbol

​
token_name
string

Full token name

​
token_type
enum<string>

Token standard type

Available options:
native,
erc20,
spl,
ton,
sui
​
network
string

Blockchain network

​
token_decimals
number

Token decimal places

​
token_address
string | null

Smart contract address (null for native tokens).

​
requires_memo
boolean

Whether memo is required

​
has_settlement_route
boolean

Whether settlement path exists

​
supports_stable_settlement
boolean | null

Whether this token can be used as a stable settlement token (when applicable).

​
is_monitored
boolean | null

Whether this token is monitored for precomputed rates (mainnet only).

​
settlement_rate
number | null

Exchange rate to settlement token

​
settlement_cost_usd
number | null

Total cost in USD after settlement

​
is_same_token_settlement
boolean | null

Whether payment and settlement tokens match

​
tier
string | null

Pricing tier

​
tier_fee
number | null

Tier-based fee amount

​
availability_status
enum<string>

Quote availability status.

Available options:
AVAILABLE,
STALE,
NO_LIQUIDITY,
QUOTE_REQUIRED,
DEVNET
​
rate_updated_at
string<date-time>

Last rate update timestamp

​
unavailable_reason
string | null

Present when has_settlement_route is false (e.g. no liquidity or stale quote data).