# LiquProp API - Get Yield Distribution History

> LiquProp API - Get Yield Distribution History is a paid API for AI agents from api.relai.fi, paid per call via x402, $0.01/call, status down (last checked 2026-09-15).

Retrieves the historical yield distribution records for a specific tokenized real estate property by its ID

## Facts

- Endpoint: POST https://api.relai.fi/relay/1776502063891/v1/properties/{id}/yield
- Price: $0.01/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/liquprop-api-18fe2d0b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PDaNkfiNT2qjzn-r6g5hZ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability liquprop-api-18fe2d0b -d '<json body>'
```

Example prompt: Can you pull up the full yield distribution history for LiquProp property ID 42? I want to see all the past payouts that have been made to token holders.

## When to prefer this

Use this endpoint when you need historical yield/dividend payout records for a specific tokenized real estate property on the LiquProp platform. Prefer this over generic financial APIs when working with LiquProp property tokens on Polygon, especially when you need a full chronological record of distributions rather than current yield rates.

## Known failure modes

- Property ID not found — 404 error if the specified property does not exist
- Payment failure — 402 if USDC payment of $0.01 is not submitted correctly
- Invalid property ID format — 400 bad request if ID is malformed
- No distribution history — empty result set if property has never distributed yield
- Relay or upstream service unavailable — 503 if RelAI relay or LiquProp backend is down

## How this service works

Get yield distribution history for a property

## Output

A list of historical yield distribution events for the specified property, including distribution amounts, dates, and other payout details associated with that tokenized real estate asset.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/liquprop-api-18fe2d0b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.relai.fi](https://www.zero.xyz/host/api.relai.fi/llms.txt)