WAX NFT API

Welcome to the univeral WAX NFT API, an API that provides information on all NFTs on the WAX Blockchain, including simpleassets and atomicassets, as well as the most smart contracts around NFTs such a drops, packs, crafting and market contract. Use this API to get current NFT listings, drops and sales history, PFP traits analytics, sets and much more.

Requirements

• Python >= 3.10
• PostgreSQL >= 14.0
• eos-chronicle > 3.0

Configuration

• Open config.py to enter the IP and PORT on which chronicle is running.
• Edit the list of smart contracts in config.py you wish to follow
• Edit chronicle-config/config.ini to add the host and port of your state history API. Also change the list of smart contracts to follow and to setup host and port of your chronicle instance. The list of contracts should be the same as in your config.py.

Installation

• Clone this repository and navigate into it.
• Run python3.10 -m venv env
• Run source env/bin/activate
• Run pip install -r requirements.txt
• Run deactivate
• Switch to your postgres profile and create a database.
• Import db_schema.sql with psql <your_database> < /path/to/wax-api/db_schema.sql
• Install Chronicle from https://github.com/EOSChronicleProject/eos-chronicle
• Create a chronicle job like vi /etc/systemd/system/chronicle.service
• Add the following content:

Description=Run Chronicle

[Service]
Type=simple
ExecStart=/usr/local/sbin/chronicle-receiver --config-dir=/path/to/wax-api/chronicle-config --data-dir=/path/to/chronicle-data
Restart=always
RestartSec=10
KillMode=process

[Install]
WantedBy=multi-user.target

• Create a job for the chronicle consumer vi /etc/systemd/system/consumer.service
• Add the following content:

Description=Chronicle Consumer

[Service]
Type=simple
ExecStart=/path/to/wax-api/env/bin/python /path/to/wax-api/chronicle_consumer.py

Restart=always
RestartSec=10
KillMode=process
Environment="DB=postgresql://root:DB_PASSWORD@0.0.0.0:5432/<your_database>"

[Install]
WantedBy=multi-user.target

• Create a job for the filler vi /etc/systemd/system/filler.service
• Add the following content:

Description=WAX API Filler

[Service]
Type=simple
ExecStart=/path/to/wax-api/env/bin/python /path/to/wax-api/filler.py

Restart=always
RestartSec=10
KillMode=process
Environment="DB=postgresql://<user>:DB_PASSWORD@0.0.0.0:5432/<your_database>"

[Install]
WantedBy=multi-user.target

• Create a job for the API vi /etc/systemd/system/api.service
• Add the following content:

Description=WAX API Service

[Service]
Type=simple
ExecStart=/path/to/wax-api/env/bin/python /path/to/wax-api/api.py

Restart=always
RestartSec=10
KillMode=process
Environment="DB=postgresql://<user>:DB_PASSWORD@0.0.0.0:5432/<your_database>"

[Install]
WantedBy=multi-user.target

Start

Run curl -L 0.0.0.0:5002/filler/start to start the filler and curl -L 0.0.0.0:5002/filler/stop to stop.

Scheduling

• Run crontab -e
• Depending on your needs, add the following commands:

*/10 * * * * curl -L 0.0.0.0:5002/filler/update-sales-summary
*/10 * * * * curl -L 0.0.0.0:5002/filler/refresh-drops-views
*/5 * * * * curl -L 0.0.0.0:5002/filler/refresh-recently-sold
*/15 * * * * curl -L 0.0.0.0:5002/filler/update-template-stats
0 */1 * * * curl -L 0.0.0.0:5002/filler/update-volumes
*/10 * * * * curl -L 0.0.0.0:5002/filler/sync-new-collection-verifications
*/30 * * * * curl -L 0.0.0.0:5002/filler/load-pfp-attributes