Tokens

List supported tokens

GET /v0/tokens

Returns the list of tokens supported by the protocol on a given chain. Only tokens in this list can be used as payment tokens in plans.

Auth: None required (public endpoint)

Query parameters:

Parameter	Type	Required	Description
chain_id	number	No	Chain ID to filter. Defaults to the indexer's configured chain.
include_disabled	boolean	No	Include disabled tokens in the response. Default: false.

Response fields:

Field	Type	Description
token_address	string	Token contract address
enabled	boolean	Whether the token is currently enabled for new plans
decimals	number	Token decimal places
min_per_tx	string	Minimum amount per transaction, in base units. "0" if no minimum.
max_per_tx	string	Maximum amount per transaction, in base units. "0" if no cap.
name	string | null	Token name (e.g. "USD Coin")
symbol	string | null	Token symbol (e.g. "USDC")

Example request:

const res = await fetch(
  'https://api.amser.io/v0/tokens?chain_id=84532'
);
const tokens = await res.json();

Example response:

[
  {
    "token_address": "0x036cbd53842c5426634e7929541ec2318f3dcf7e",
    "enabled": true,
    "decimals": 6,
    "min_per_tx": "100000",
    "max_per_tx": "0",
    "name": "USD Coin",
    "symbol": "USDC"
  }
]

In this example, min_per_tx of "100000" with 6 decimals means a minimum of 0.1 USDC per transaction. max_per_tx of "0" means no upper cap.

---

Get token policy

GET /v0/tokens/:address

Returns the policy for a specific token address.

Auth: None required (public endpoint)

Path parameters:

Parameter	Type	Description
address	string	Token contract address (0x…)

Query parameters:

Parameter	Type	Required	Description
chain_id	number	No	Chain ID to filter

The response shape is identical to a single element from the list endpoint. Returns 404 if no policy exists for the given token address.

Related

• Plans — Plan details including payment token configuration
• Smart Contracts — Contract reference documentation