Public API

Here, you'll find everything you need to know about accessing and interacting with our Public API endpoints. Our API allows you to seamlessly integrate our services into your applications. Below is an overview of the key endpoints available to you, along with detailed descriptions and usage instructions.

Base URL

Base URL for all endpoints listed on this page

https://mainnet.api.perawallet.app/v1/public/

Swagger

Pera Wallet API

Pera Wallet Public API Swagger

Verified Asset List

This is a simplified endpoint that returns all verified assets in a single response. The endpoint returns verified assets with asset verification label by excluding suspicious and unverified ones. If your business logic needs to know the verified asset ids, this is the endpoint you should use. It is lightweight and doesn't require pagination.

• Response is cached for 5 min.

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

Query parameters

Response

200

Body

application/json

asset_id*Asset id

verification_tier*Verification tier

trustedverifiedunverifiedsuspicious

Request

JavaScriptCurl

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

Response

[
  {
    "verification_tier": "trusted"
  }
]

Labeled Asset List

This is a simplified endpoint that returns all labeled assets in a single response. The endpoint returns verified and suspicious assets with asset verification label by excluding unverified ones. If your business logic needs to know the labeled asset ids, this is the endpoint you should use. It is lightweight and doesn't require pagination.

• Response is cached for 5 min.

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

Query parameters

Response

200

Body

application/json

asset_id*Asset id

verification_tier*Verification tier

trustedverifiedunverifiedsuspicious

Request

JavaScriptCurl

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

Response

[
  {
    "verification_tier": "trusted"
  }
]

Asset List

This public endpoint returns all assets.

• Response is cached for 5 min.
• Maximum page size: 1000
• Default page size: 50
• Page size options: 50, 100, 500, 1000

GEThttps://mainnet.api.perawallet.app/v1/public/assets/

Query parameters

Response

200

Body

application/json

nextnullable string (uri)

previousnullable string (uri)

results*array of PublicAssetSerializer.Response (object)

Request

JavaScriptCurl

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

Response

{
  "next": "https://example.com",
  "previous": "https://example.com",
  "results": [
    {
      "name": "text",
      "unit_name": "text",
      "is_deleted": "text",
      "creator_address": "text",
      "url": "text",
      "logo": "https://example.com",
      "verification_tier": "trusted",
      "usd_value": "text",
      "is_collectible": false
    }
  ]
}

Asset Verification Detail

This public 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/public/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/public/asset-verifications/{asset_id}/', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

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

Asset Detail

This public endpoint returns details of an asset.

• Response is cached for 5 min.

GEThttps://mainnet.api.perawallet.app/v1/public/assets/{asset_id}/

Path parameters

asset_id*string

Query parameters

Response

200

Body

application/json

asset_id*Asset id

nameName

unit_nameUnit name

fraction_decimals*Fraction decimals

total_supply*Total supply

is_deletedIs deleted

creator_address*Creator address

urlUrl

logoLogo

verification_tier*Verification tier

trustedverifiedunverifiedsuspicious

usd_valueUsd value

is_collectible*Is collectible

verification_detailsPublicVerificationDetails (object)

collectiblePublicCollectible (object)

The Algonode IPFS service is used for convenience in thumbnail_url and media.url. We recommend you to sign-up for a dedicated plan from Algonode.

Request

JavaScriptCurl

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

Response

{
  "name": "text",
  "unit_name": "text",
  "is_deleted": "text",
  "creator_address": "text",
  "url": "text",
  "logo": "https://example.com",
  "verification_tier": "trusted",
  "usd_value": "text",
  "is_collectible": false,
  "verification_details": {
    "project_name": "text",
    "project_url": "https://example.com",
    "project_description": "text",
    "discord_url": "https://example.com",
    "telegram_url": "https://example.com",
    "twitter_username": "text"
  },
  "collectible": {
    "title": "text",
    "description": "text",
    "standards": [
      "text"
    ],
    "thumbnail_url": "https://example.com",
    "thumbnail_ipfs_cid": "text",
    "media": [
      {
        "type": "image",
        "url": "text",
        "ipfs_cid": "text",
        "extension": "text"
      }
    ],
    "traits": [
      {
        "display_name": "text",
        "display_value": "text"
      }
    ]
  }
}

Usage Requirements

To use Pera Wallet Public API you must comply with the following requirements:

• Please note “Data provided by Pera“ & display the Pera logo

• Display the Pera Verified and Suspicious badges next to each ASA

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

All brand assets are available at our media kit.

Deprecation Notice

As part of this expansion, we are restructuring our existing public endpoints. The current v1/ endpoints will be moved to the v1/public/ path.

There will not be any change in the response format of these APIs, but the requests will be redirected to the new path starting August 1st 2024. It is important for users to migrate their projects to the new path to ensure faster access to the API.