# Genexxis Yield Curve API

> Genexxis Yield Curve API is a paid API for AI agents from yields.genexxis.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-29).

Returns the full government yield curve (all tenors with yield %, change in bp vs 1 month and 1 year ago) for the US, euro area AAA, or Morocco.

## Facts

- Endpoint: GET https://yields.genexxis.com/curve?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/genexxis-yield-curve-api-24c8cab4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_op6PKtE5vyCUqXlxK7xwP

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 genexxis-yield-curve-api-24c8cab4
```

Example prompt: Can you pull the full US government yield curve right now, including how yields have moved compared to a month ago and a year ago across all tenors?

## When to prefer this

Use this endpoint when you need the complete yield curve across all standard tenors for US Treasuries, euro area AAA, or Moroccan government bonds, especially when you also need historical context (1-month and 1-year basis point changes). Prefer this over the sibling interpolation endpoint when you want a full curve snapshot rather than a single specific tenor, and over the slopes endpoint when you need raw yield levels rather than derived spread metrics.

## Known failure modes

- Invalid country code returns an error (only US, EA, MA are accepted)
- Data may be stale if the upstream government source has not published for the day
- Network or payment failure returns a 402 or 5xx status

## How this service works

Official government yield curves for agents: U.S. Treasury par yield curve (1M-30Y, U.S. Treasury), euro area AAA spot curve (3M-30Y, ECB) and Morocco Treasury bond reference rates (Bank Al-Maghrib secondary market), each with changes vs 1 month and 1 year ago; curve slopes (2s10s, 3m10y) with inversion flags, cross-market 10Y spreads, and interpolated yields at any tenor. Refreshed every 6 hours from official publications.

## Output

A JSON object containing the country, as-of date, data source name, and an array of yield curve points each with tenor label, years to maturity, yield percentage, and basis-point changes versus one month ago and one year ago.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "country"
     ],
     "properties": {
      "country": {
       "type": "string",
       "description": "US, EA (euro area AAA) or MA (Morocco)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "asOf": "2026-10-23",
  "points": [
   {
    "tenor": "2Y",
    "years": 2,
    "chg1mBp": -12,
    "chg1yBp": 85,
    "yieldPct": 4.61
   },
   {
    "tenor": "10Y",
    "years": 10,
    "chg1mBp": -20,
    "chg1yBp": 96,
    "yieldPct": 4.98
   }
  ],
  "source": "U.S. Treasury daily par yield curve rates",
  "country": "US"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/genexxis-yield-curve-api-24c8cab4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from yields.genexxis.com](https://www.zero.xyz/host/yields.genexxis.com/llms.txt)
