GET
/
api
/
v1
/
tokens
/
list
List Tokens
curl --request GET \
  --url https://prv.explorer.biya.io/api/v1/tokens/list \
  --header 'Authorization: Bearer <token>'
{
  "code": 123,
  "message": "<string>",
  "data": {}
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

chain_id
string

Chain ID filter (optional, default: biyachain-1)

contract_type
string

Contract type filter (optional, e.g., "erc20", "erc721")

Search by token name, symbol, or contract address (optional, fuzzy match)

sort_by
string

Sort field: market_cap, volume_24h, price, holders, deployment_time (optional)

sort_order
string

Sort order: asc or desc (optional, default: desc)

tag_type
string

Filter by tag type (optional, e.g., "stablecoin", "official")

verification_status
string

Filter by verification status (optional, e.g., "verified", "unverified")

denom
string

Filter by peggy denom (optional, e.g., "peggy0x...")

pagination.page
integer<int32>

Page number, starts from 1, default 1 (for page-based pagination)

pagination.page_size
integer<int32>

Page size, default 20, maximum 100

pagination.cursor
string

Cursor (for cursor-based pagination, optimized for large datasets, takes priority over page) For blocks: use block height (height) For transactions: use transaction number (tx_number) or combination of block height + transaction number

Response

200 - application/json

OK

Generic response structure

code
integer<int32>

Response status code, 0 indicates success, non-zero indicates failure

message
string

Response message

data
object

Response data (using Struct type to directly return JSON objects, more intuitive)