Aave Incentives API

➡️ Live on https://aave-incentives-api.vercel.app

Abstract

This project provides an API to access incentives data from the Aave protocol. It enables developers and users to retrieve information about all the incentives across supported Aave instances.

Setup

# Install packages
pnpm i

# Set env var
cp .example.env .env

# Then set your own env var in your freshly created .env file

# Start the development server
pnpm run dev

The API will be available at http://localhost:8000

API Docs

This API is fully documented using OpenAPI:

• 📘 Docs: https://aave-incentives-api.vercel.app/docs
• 📄 OpenAPI file

API Overview

The API exposes a REST interface to query Aave incentives data.

• GET /incentives: Retrieve a list of incentives with optional filters for chain ID, status, incentive type, and reward type
• GET /health: Check the health status of the API
• GET /wrapper-tokens: Retrieve the list of all supported wrapper tokens and their underlying assets
• GET /wrapper-tokens/:wrapperTokenAddress: Resolve the underlying asset for a given wrapper token address

Features

• Node.js Express REST API
• Fetch incentives across multiple sources:
  • ACI infra incentives
  • Merkl infra incentives
  • Onchain incentives
  • External Points incentives
• Support all Aave V3 instances

License

This project is licensed under the MIT License. See the LICENSE file for details.