Verified ASA APIs

API documentation on how to fetch details on any ASA, along with its verification status.

Pera's Verified ASA APIs provide verification status on every ASA on Mainnet, as well as their Pera Explorer URLs. To be allowed to use Pera Verified ASA APIs, you must also comply with the following requirements:

• Show Pera's logo and Pera's Verified, Trusted and Suspicious badges next to each ASA, clearly visible for your users. All brand assets are available at our media kit.

• Link to the ASA's Pera Explorer page, with the Pera logo and "View on Pera Explorer" call to action clearly visible.

Base URL

Base URL for all endpoints listed on this page is: https://mainnet.api.perawallet.app/v1/

Asset Verification Detail

This endpoint returns Asset verification information about a specific ASA on the Algorand blockchain. This is the recommended public API for fetching the verification status of an ASA from Pera. More details about the verification program can be found here: https://explorer.perawallet.app/asa-verification/

GEThttps://mainnet.api.perawallet.app/v1/asset-verifications/{asset_id}/

Path parameters

asset_id*integer

Response

200

Body

application/json

asset_id*Asset id

verification_tier*Verification tier

trustedverifiedunverifiedsuspicious

explorer_url*Explorer url

Request

JavaScriptCurl

const response = await fetch('https://mainnet.api.perawallet.app/v1/asset-verifications/{asset_id}/', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "verification_tier": "trusted",
  "explorer_url": "https://example.com"
}

Verified Asset List

This endpoint returns verified and trusted asset ids.

Pagination is handled via the limit query parameter.

GEThttps://mainnet.api.perawallet.app/v1/verified-assets/

Query parameters

Response

200

Body

application/json

nextnullable string (uri)

previousnullable string (uri)

results*array of SimpleAssetSerializer.Response (object)

Request

JavaScriptCurl

const response = await fetch('https://mainnet.api.perawallet.app/v1/verified-assets/', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "next": "https://example.com",
  "previous": "https://example.com",
  "results": [
    {
      "verification_tier": "trusted"
    }
  ]
}

Labeled Asset List

This endpoint returns verified trusted suspicious assets with asset verification information by excluding unverified ones.

Pagination is handled via the limit query parameter.

GEThttps://mainnet.api.perawallet.app/v1/labeled-assets/

Query parameters

Response

200

Body

application/json

nextnullable string (uri)

previousnullable string (uri)

results*array of SimpleAssetSerializer.Response (object)

Request

JavaScriptCurl

const response = await fetch('https://mainnet.api.perawallet.app/v1/labeled-assets/', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "next": "https://example.com",
  "previous": "https://example.com",
  "results": [
    {
      "verification_tier": "trusted"
    }
  ]
}