Api Endpoint

Agent Mercantile

Observe factual Aave V3 lending supply APR and Lido staking APR for one Ethereum/Base asset, with timestamps, evidence, explicit rate labels, optional filters/sort, and limitations. No ranking or investment recommendation. Call when you need currently observed supported-venue rates for one asset, not a ranking.

Open interactive test console

Offering

Provider
api.agentmercantile.com
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Blockchain And Crypto
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://api.agentmercantile.com/v1/productive-venue-snapshot
MIME type
Not provided
First seen
2026-10-16T01:50:14.534Z
Last seen
Tags
yield, productive-venue, lending-rate, supply-apr, staking-apr

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.01 USDC
Atomic price: 10000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "10000",
    "payTo": "0xdb7b2b54f80479826222749a2ea73a8acc306e1e"
  }
]

Observed health

Status
Healthy
Latest latency
100 ms
Average latency
522 ms
HTTP status
200
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "body": {
      "additionalProperties": false,
      "properties": {
        "asset": {
          "additionalProperties": false,
          "description": "native, erc20, or allowlisted symbol asset object",
          "properties": {
            "address": {
              "description": "Required for erc20. Exact nonzero 20-byte EVM address.",
              "type": "string"
            },
            "kind": {
              "enum": [
                "native",
                "erc20",
                "symbol"
              ],
              "type": "string"
            },
            "symbol": {
              "description": "Required for kind=symbol. Allowlist ETH, WETH, USDC, stETH, wstETH. Chain-specific.",
              "type": "string"
            }
          },
          "required": [
            "kind"
          ],
          "type": "object"
        },
        "chain_id": {
          "description": "Ethereum 1 or Base 8453 only.",
          "enum": [
            1,
            8453
          ],
          "type": "integer"
        },
        "limit": {
          "description": "Default 20. Applied after filters and sort.",
          "maximum": 20,
          "minimum": 1,
          "type": "integer"
        },
        "protocols": {
          "items": {
            "enum": [
              "aave_v3",
              "lido"
            ],
            "type": "string"
          },
          "minItems": 1,
          "type": "array",
          "uniqueItems": true
        },
        "sort": {
          "description": "Objective sort only. rate_* uses primary_apr. Null rates sort last. Not a recommendation.",
          "enum": [
            "protocol",
            "rate_desc",
            "rate_asc"
          ],
          "type": "string"
        },
        "venue_types": {
          "items": {
            "enum": [
              "lending",
              "liquid_staking"
            ],
            "type": "string"
          },
          "minItems": 1,
          "type": "array",
          "uniqueItems": true
        }
      },
      "required": [
        "chain_id",
        "asset"
      ],
      "type": "object"
    },
    "bodyType": {
      "enum": [
        "json",
        "form-data",
        "text"
      ],
      "type": "string"
    },
    "method": {
      "enum": [
        "POST"
      ],
      "type": "string"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "type": "object"
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "additionalProperties": false,
          "properties": {
            "asset": {
              "additionalProperties": false,
              "description": "native, erc20, or allowlisted symbol asset object",
              "properties": {
                "address": {
                  "description": "Required for erc20. Exact nonzero 20-byte EVM address.",
                  "type": "string"
                },
                "kind": {
                  "enum": [
                    "native",
                    "erc20",
                    "symbol"
                  ],
                  "type": "string"
                },
                "symbol": {
                  "description": "Required for kind=symbol. Allowlist ETH, WETH, USDC, stETH, wstETH. Chain-specific.",
                  "type": "string"
                }
              },
              "required": [
                "kind"
              ],
              "type": "object"
            },
            "chain_id": {
              "description": "Ethereum 1 or Base 8453 only.",
              "enum": [
                1,
                8453
              ],
              "type": "integer"
            },
            "limit": {
              "description": "Default 20. Applied after filters and sort.",
              "maximum": 20,
              "minimum": 1,
              "type": "integer"
            },
            "protocols": {
              "items": {
                "enum": [
                  "aave_v3",
                  "lido"
                ],
                "type": "string"
              },
              "minItems": 1,
              "type": "array",
              "uniqueItems": true
            },
            "sort": {
              "description": "Objective sort only. rate_* uses primary_apr. Null rates sort last. Not a recommendation.",
              "enum": [
                "protocol",
                "rate_desc",
                "rate_asc"
              ],
              "type": "string"
            },
            "venue_types": {
              "items": {
                "enum": [
                  "lending",
                  "liquid_staking"
                ],
                "type": "string"
              },
              "minItems": 1,
              "type": "array",
              "uniqueItems": true
            }
          },
          "required": [
            "chain_id",
            "asset"
          ],
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "additionalProperties": true,
          "properties": {
            "asset": {
              "type": "object"
            },
            "block_number": {
              "type": "string"
            },
            "cached": {
              "type": "boolean"
            },
            "chain_id": {
              "enum": [
                1,
                8453
              ],
              "type": "integer"
            },
            "classification": {
              "enum": [
                "OBSERVED_COMPLETE",
                "OBSERVED_PARTIAL",
                "OBSERVED_EMPTY_SUPPORTED_SET",
                "HOLD_UPSTREAM",
                "HOLD_OUTPUT_REFUSED"
              ],
              "type": "string"
            },
            "errors": {
              "type": "array"
            },
            "evidence": {
              "type": "array"
            },
            "limitations": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "machine": {
              "enum": [
                "VM04"
              ],
              "type": "string"
            },
            "methodology_version": {
              "enum": [
                "productive-venue-0.2.0"
              ],
              "type": "string"
            },
            "observation_age_ms": {
              "type": "integer"
            },
            "omissions": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "protocol_set_version": {
              "type": "string"
            },
            "request": {
              "type": "object"
            },
            "resolved": {
              "type": "object"
            },
            "result_count": {
              "type": "integer"
            },
            "retrieved_at": {
              "type": "string"
            },
            "sort": {
              "type": "object"
            },
            "status": {
              "enum": [
                "OK",
                "PARTIAL",
                "HOLD"
              ],
              "type": "string"
            },
            "truncated": {
              "type": "boolean"
            },
            "venues": {
              "type": "array"
            }
          },
          "required": [
            "status",
            "classification",
            "machine",
            "methodology_version",
            "protocol_set_version",
            "chain_id",
            "asset",
            "request",
            "resolved",
            "sort",
            "result_count",
            "truncated",
            "omissions",
            "retrieved_at",
            "venues",
            "limitations",
            "errors",
            "evidence"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}