# 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

{% embed url="<https://api.perawallet.app/v1/documentation/>" %}
Pera Wallet Public API Swagger
{% endembed %}

{% openapi src="/files/jTNPGk4awuDjc1LBuXkF" path="/public/verified-assets/" method="get" %}
[public\_api\_swagger.yaml](https://96496224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4vifTUgliUpqzu4s88gd%2Fuploads%2FyUb3dR2ldl3i0qV3iqsD%2Fpublic_api_swagger.yaml?alt=media\&token=b02b4af7-cc4c-4532-954e-399c213aea98)
{% endopenapi %}

{% openapi src="/files/jTNPGk4awuDjc1LBuXkF" path="/public/labeled-assets/" method="get" %}
[public\_api\_swagger.yaml](https://96496224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4vifTUgliUpqzu4s88gd%2Fuploads%2FyUb3dR2ldl3i0qV3iqsD%2Fpublic_api_swagger.yaml?alt=media\&token=b02b4af7-cc4c-4532-954e-399c213aea98)
{% endopenapi %}

{% openapi src="/files/jTNPGk4awuDjc1LBuXkF" path="/public/assets/" method="get" %}
[public\_api\_swagger.yaml](https://96496224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4vifTUgliUpqzu4s88gd%2Fuploads%2FyUb3dR2ldl3i0qV3iqsD%2Fpublic_api_swagger.yaml?alt=media\&token=b02b4af7-cc4c-4532-954e-399c213aea98)
{% endopenapi %}

{% openapi src="/files/jTNPGk4awuDjc1LBuXkF" path="/public/asset-verifications/{asset\_id}/" method="get" %}
[public\_api\_swagger.yaml](https://96496224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4vifTUgliUpqzu4s88gd%2Fuploads%2FyUb3dR2ldl3i0qV3iqsD%2Fpublic_api_swagger.yaml?alt=media\&token=b02b4af7-cc4c-4532-954e-399c213aea98)
{% endopenapi %}

{% openapi src="/files/jTNPGk4awuDjc1LBuXkF" path="/public/assets/{asset\_id}/" method="get" %}
[public\_api\_swagger.yaml](https://96496224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4vifTUgliUpqzu4s88gd%2Fuploads%2FyUb3dR2ldl3i0qV3iqsD%2Fpublic_api_swagger.yaml?alt=media\&token=b02b4af7-cc4c-4532-954e-399c213aea98)
{% endopenapi %}

### 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](https://perawallet.app/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.&#x20;

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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.perawallet.app/references/public-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.