find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/alertio-io:alertio-io-aave-position-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Alertio Public Data Aave Position API
  version: 1.0.0
  summary: Read-only DeFi risk and market data — lending utilization, stablecoin pegs, perp funding, position health.
  description: 'The read endpoints behind alertio.io, offered as-is for agents and integrations.


    Rate limited per minute: 8 anonymous (by IP), 60 authenticated (by user). Some routes set tighter limits — see each operation. Over the limit returns 429.


    Browser requests are checked against an Origin/Referer allowlist and get 403 from other origins (allowed: https://alertio.io, https://www.alertio.io). Server-to-server and agent callers send no Origin header and are unaffected.


    Position endpoints are address-based and read-only: they take a public address and read it the way a block explorer does. No signature, connection, or key material is involved.


    Alerting itself is not exposed here — creating and managing alert rules requires an account and is not part of this API.'
  contact:
    name: Alertio
    email: contact@alertio.io
    url: https://www.alertio.io
  license:
    name: Proprietary
    url: https://www.alertio.io/terms
servers:
- url: https://www.alertio.io
  description: Production
tags:
- name: Aave Position
paths:
  /api/aave-position:
    get:
      operationId: aave_position
      summary: Aave V3 position for an address
      description: 'Health factor, collateral and debt for one address on one chain. Read-only and address-based — no signature or connection is involved. Rate limited more tightly than the market endpoints because each call reads a paid upstream.


        Rate limit: 6/min anonymous, 30/min authenticated.'
      parameters:
      - name: address
        in: query
        required: true
        description: EVM address, 0x + 40 hex.
        schema:
          type: string
          example: '0x0000000000000000000000000000000000000000'
      - name: chain
        in: query
        required: true
        description: Chain the position is on. A 400 lists the supported set.
        schema:
          type: string
          example: ethereum
      responses:
        '200':
          description: Payload under `(position fields at the top level)`, with `fetchedAt` (epoch ms) alongside it.
          content:
            application/json:
              schema:
                type: object
                properties:
                  fetchedAt:
                    type: integer
                    description: Epoch milliseconds when the data was read.
        '400':
          description: Invalid or missing query parameter. The message names what was wrong.
        '403':
          description: Origin/Referer not on the browser allowlist.
        '429':
          description: Rate limit exceeded.
        '503':
          description: An upstream data source failed. Retry shortly.
      tags:
      - Aave Position