# Annual Profections API

> Annual Profections API. Calculate the annual profection and lord of the year for any birth chart and target date using the Hellenistic time lord

- Capability page: https://roxyapi.com/apis/profections-api
- Full domain: https://roxyapi.com/products/astrology-api
- OpenAPI spec: https://roxyapi.com/api/v2/astrology/openapi.json
- Remote MCP server: https://roxyapi.com/mcp/astrology

## Overview

Calculate the annual profection and lord of the year for any birth chart and target date using the Hellenistic time lord technique. Each completed year of life advances the rising sign by one whole sign house, activating a new profected house, profected sign, and ruling planet that sets the tone of the year. Returns the age, profected house and sign, the lord of the year with its natal sign and house placement, and a plain language interpretation for traditional and Hellenistic astrology apps.

## Endpoints

- `POST /api/v2/astrology/profections` Annual profections calculator - lord of the year and yearly time lord by age

## Example request

```bash
curl -X POST "https://roxyapi.com/api/v2/astrology/profections" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-07-15","time":"14:30:00","latitude":40.7128,"longitude":-74.006,"timezone":-5,"targetDate":"2025-08-04"}'
```

## Example response

```json
{
  "birthDetails": {
    "date": "1990-07-15",
    "time": "14:30:00",
    "latitude": 40.7128,
    "longitude": -74.006,
    "timezone": -5
  },
  "targetDate": "2025-08-04",
  "age": 30,
  "profectedHouse": 7,
  "profectedSign": "Leo",
  "lordOfYear": "Sun",
  "lordNatalPosition": {
    "sign": "Leo",
    "house": 6
  },
  "interpretation": "string",
  "summary": "At age 30, the annual profection activates house 7 in Leo, making Sun the lord of the year for 2025-08-04."
}
```

## Remote MCP

Every endpoint is a callable tool on the Remote MCP server at https://roxyapi.com/mcp/astrology over Streamable HTTP. Tool name for `POST /astrology/profections`: `post_astrology_profections`. `tools/list` is free; `tools/call` bills the same as REST.

## FAQ

### What does the Annual Profections API return?

Calculate the annual profection and lord of the year for any birth chart and target date using the Hellenistic time lord technique. Every response is structured JSON with documented fields, not free text, so you map it straight into your product.

### How do I authenticate with the Annual Profections API?

Pass your key in the X-API-Key header on every request. Keys are delivered instantly at checkout with no approval queue. Use a secret sk key server side, or mint a publishable pk key locked to your origins for browser and no-code use.

### Does the Annual Profections API support multiple languages?

Yes. Append the lang query parameter to any endpoint for responses in English, German, Spanish, French, Hindi, Portuguese, Russian and Turkish. The translated payload includes the full interpretation text, not just field labels.

### Do I need coordinates to call the Annual Profections API?

No. Call GET /location/search with a city name first, then pass latitude, longitude, and timezone from the first result into the request. Never ask users to type coordinates. Timezone accepts a decimal offset or an IANA name.

### Is the Annual Profections API available over Remote MCP for AI agents?

Yes. Every endpoint is exposed as a callable tool on the Remote MCP server at https://roxyapi.com/mcp/astrology over Streamable HTTP, so Claude, ChatGPT, Cursor, and any MCP client auto-discover it with no local setup or Docker.

### How is the Annual Profections API billed?

Flat pricing: 1 request equals 1 quota unit, REST and MCP identical, with no credit weighting or per-token markup. Every plan includes all 12 domains, so the Annual Profections API is included at no extra cost.

### What lang values does the Annual Profections API accept?

The lang parameter accepts en, tr, de, es, hi, pt, fr, ru. Case-insensitive where it is a path value.

## Full reference

Fetch the OpenAPI spec at https://roxyapi.com/api/v2/astrology/openapi.json. Master agent manifest at https://roxyapi.com/llms.txt.