Quick Start

Four Easy Steps to Sell TPAs on Your Website Using StageMeta REST API

• Lookup API: Use the Lookup API to check the availability of a specific TPA. This step ensures that the TPA you are trying to sell has a unique identifier and can be minted without any errors.

• Prepare API: Use the Prepare API to format the TPA data before sending it to the blockchain. This step ensures that the TPA data is properly formatted and ready for the blockchain.

You can generate an API key from your Dashboard at any time.

• Owner Username API: Use the Owner Username API to get the owner of the TPA. This step is essential to ensure that the TPA has a valid username and is eligible for Meta energy.

• Buy API: Use the Buy API to purchase the TPA and send it to the buyer's wallet. This step completes the transaction and ensures that the buyer receives the TPA they purchased.

Base URL in all API calls

Production Version:

https://api.stagemeta.world

Staging (Test) Version:

https://api.stagemeta.dev

Good to know: For using the staging environment you have to switch your wallet to goerli test network.

Make your first request

To make your first request, send an authenticated request to the pets endpoint. This will create a pet, which is nice.

Featured Plaques list

POST https://api.stagemeta.dev/plaques/featured

Get the list of featured plaques.

200: OK

{
  "count": 20,
  "plaques": [
    {
      "id": 1000,
      "createdAt": "2023-03-28T15:06:27.483Z",
      "updatedAt": "2023-03-29T10:11:25.086Z",
      "deletedAt": null,
      "name": "tpa-000",
      "alphabetPart": "tpa",
      "numberPart": "000",
      "image": "https://cdn.stagemeta.world/palques/tpa-000.jpg",
      "price": 0,
      "currency": "ETH",
      "marketplace": "stage",
      "tokenId": null,
      "mappedPlaqueId": null,
      "contractAddress": "0x000000000000000000000000000000000000000",
      "featured": true,
      "description": "",
      "standard": "ERC-1155",
      "metadata": null,
      "building_id": null,
      "wallet_address": null,
      "condition": "VIRGIN",
      "assignAt": null,
      "saleAt": null,
      "featuredAt": "2023-03-28T15:06:27.481Z",
      "mintedAt": null,
      "status": "AVAILABLE",
      "minted": false,
      "token_id": null
    }
  ],
  
}

Take a look at what you might call this method:

Curl

curl -X 'GET' \ 'https://api.stagemeta.world/plaques/featured' \ -H 'accept: */*'

Node

fetch('https://api.stagemeta.world/plaques/featured', {
  method: 'GET',
  headers: {
    'accept': '*/*'
  }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error(error));