# ZNS API

### Base URL: `https://zns.bio/api`

## 1. Resolve Domain

Endpoint:

{% code title="GET" %}

```markup
/resolveDomain?chain=<CHAIN_ID>&domain=<YOUR_DOMAIN>
```

{% endcode %}

Query Parameters:

<table><thead><tr><th width="132">Name</th><th width="139">Type</th><th>Description</th></tr></thead><tbody><tr><td>chain</td><td>Number</td><td>Chain id</td></tr><tr><td>domain</td><td>String</td><td>Domain to look for</td></tr></tbody></table>

#### Request URL Example:

{% code title="GET" fullWidth="false" %}

```markup
zns.bio/api/resolveDomain?chain=137&domain=haodev007
```

{% endcode %}

Response:

```json
{
  "code": 200,
  "address": "0x181EB6D5D3fD8FbACcb422237197826c6ac70232"
}
```

## 2. Resolve Address

Endpoint:

{% code title="GET" %}

```markup
/resolveAddress?chain=<CHAIN_TLD>&address=<YOUR_ADDRESS>
```

{% endcode %}

Query Parameters:

<table><thead><tr><th width="132">Name</th><th width="139">Type</th><th>Description</th></tr></thead><tbody><tr><td>chain</td><td>Number</td><td>Chain id</td></tr><tr><td>address</td><td>String</td><td>Address to look for</td></tr></tbody></table>

#### Request URL Example:

{% code title="GET" %}

```markup
zns.bio/api/resolveAddress?chain=137&address=0x181EB6D5D3fD8FbACcb422237197826c6ac70232
```

{% endcode %}

Response:

```json
{
  "code": 200,
  "primaryDomain": "cyberstorm",
  "userOwnedDomains": [
    "cyberstorm",
    "dontneedhelp",
    "enemymaycry",
    "residentevil"
  ]
}
```

**Here is an example of partner** [**integration**](https://app.kiloex.io/trade?sCode=zns\&utm_source=referral\&utm_medium=zns)&#x20;

## <mark style="color:orange;">**KiloEx Platform from Binance Labs**</mark>

{% embed url="<https://app.kiloex.io/>" %}
KiloEx integration of ZNS API
{% endembed %}

<figure><img src="https://3874212134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhW9AQmr1PaiHVHE4euN%2Fuploads%2FBE0dlpqvtseNc24yrhxE%2FScreenshot%202024-06-19%20at%2008.59.08.png?alt=media&#x26;token=e6d1d06b-24ac-450b-bd7e-f6b0a00309b6" alt=""><figcaption><p>KiloEx integration of ZNS Rest API</p></figcaption></figure>

## <mark style="color:orange;">The Trailblazers platform from Taiko Team</mark>&#x20;

{% embed url="<https://trailblazers.taiko.xyz/>" %}
API integration of ZNS Taiko to Trailblazers portal
{% endembed %}

<figure><img src="https://3874212134-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhW9AQmr1PaiHVHE4euN%2Fuploads%2F6rcfJGltSIJwf7qMQW3r%2FScreenshot%202024-07-22%20at%2017.44.42.png?alt=media&#x26;token=1c9538f6-50e4-4602-a095-157c1c9559dc" alt=""><figcaption><p>Link your wallet to the Trailblazers website to update your profile with your new domain names</p></figcaption></figure>