---
title: "Request on-chain purchase parameters"
method: POST
path: "/domains/{domainName}/parameters/purchase"
tags: ["domains"]
---

# Request on-chain purchase parameters

`POST /domains/{domainName}/parameters/purchase`

## Request

- Base URL: `https://api.unstoppabledomains.com/registry/v1`
- URL: `https://api.unstoppabledomains.com/registry/v1/domains/{domainName}/parameters/purchase`
- Auth: none declared
- TypeScript: <https://skmtc.dev/unstoppabledomains/apis/registry-api-v1/docs/domains/:domainName/parameters/purchase/post.ts> (a function with typed inputs; its response is checked against the schema)

Request on-chain purchase parameters. There parameters contain all necessary data to make a purchase on-chain. It includes tx parameters with signatue. Parameters are valid for 4 hours.

## Path parameters

- `domainName` string, required

## Request body

- DomainPurchaseParametersRequest
  - `owner` DomainOwner, required
    - `address` string, required: Ethereum address
  - `records` DomainRecords, required: Domain crypto records
  - `currency` 'MATIC', required: Purchase cryptocurrency

## Response `200`

Valid

- DomainPurchaseParametersResponse
  - `domain` string: Domain name
  - `availability` Availability
    - `status` 'AVAILABLE' | 'DISALLOWED': Availability status
    - `price` DomainPriceResponse
      - `listPrice` DomainPriceItemResponse, required
        - `usdCents` number, required
      - `subTotal` DomainPriceItemResponse, required
        - `usdCents` number, required
  - `tx` DomainPurchaseParametersTx
    - `chainId` number, required: Chain ID
    - `function` string, required: Signature of function for execute on-chain
    - `arguments` DomainPurchaseParametersTxArgs, required
      - `owner` string: Domain owner address
      - `expiration` number: Expiration of purchase parameters
      - `labels` string[]: Domain labels
      - `keys` string[]: Domain record keys
      - `values` string[]: Domain record values
      - `price` string: Domain price in defined cryptocurrency (hex format)
      - `signature` string: Signature of purchase parameters
    - `params` DomainPurchaseParametersTxParams, required
      - `to` string, required: Target address
      - `data` string, required: Transaction data. Decoded data for smart contract function call
      - `value` string, required: Transaction value (hex format)

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/unstoppabledomains/apis/registry-api-v1.md) - [All operations](https://skmtc.dev/unstoppabledomains/apis/registry-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/unstoppabledomains/apis/registry-api-v1/revisions/c9c9160c1781?raw)