API & MCP Guide

aiSwingX™ analyzes US filings and reports them as news investors can read.
33 0

There are three ways to pull posts. Free posts need no key; full paid posts and per-ticker numbers open with a subscriber key. Get or manage keys under Account → API & MCP.

1. MCP — connect an AI assistant

Lets Claude, ChatGPT, Cursor and similar tools read and cite this site directly.

ServerURLAuthWhat you get
Freehttps://aiswingx.com/mcpnoneFree posts in full; paid posts as four lines
Prohttps://aiswingx.com/mcp/proAuthorization: Bearer asx_…Full paid posts + per-ticker metrics

Claude (claude.ai · Claude Desktop)

Settings → Connectors → "Add custom connector" → URL https://aiswingx.com/mcp/pro, header Authorization: Bearer asx_…. Then just ask, e.g. "find the latest SOFI post".

Claude Code · Cursor · others (JSON config)

{
  "mcpServers": {
    "aiswingx": {
      "url": "https://aiswingx.com/mcp/pro",
      "headers": { "Authorization": "Bearer asx_YOUR_KEY" }
    }
  }
}

ChatGPT (developer mode · custom GPT)

Settings → Connectors → add MCP server → URL https://aiswingx.com/mcp (free) or /mcp/pro with the header.

Tools

2. REST API

GET https://aiswingx.com/api/v1                      # index
GET https://aiswingx.com/api/v1/posts?ticker=SOFI    # list
GET https://aiswingx.com/api/v1/posts/sofi-2026q2    # one post
GET https://aiswingx.com/api/v1/search?q=fair+value
GET https://aiswingx.com/api/v1/tickers
GET https://aiswingx.com/api/v1/metrics/SOFI         # subscriber key

Authorization: Bearer asx_YOUR_KEY

Responses are JSON. A post carries four_lines (number, analogy, source, watch_next), body_md, faq, metrics and url.

curl

curl -H "Authorization: Bearer asx_…" "https://aiswingx.com/api/v1/posts/sofi-2026q2"

Python

import requests
r = requests.get("https://aiswingx.com/api/v1/posts", params={"ticker": "SOFI"},
                 headers={"Authorization": "Bearer asx_…"})
for p in r.json()["items"]:
    print(p["ticker"], p["quarter"], p["four_lines"]["number"], p["url"])

3. RSS · plain text

Limits & rules

Frequently asked questions

Where do I get an API key?

A key is issued automatically on the payment confirmation page when a paid subscription starts, and can be viewed, reissued or revoked under Account → API & MCP.

What is MCP?

A standard that lets AI assistants such as Claude and ChatGPT read external services directly. Connect this server and your assistant can search and cite aiSwingX™ articles.

What happens when I exceed the call limit?

Requests return 429 until the limit resets the next day. For higher limits, use the License plan or contact us.

What are the rules for republishing?

Cite the article URL and the filing source. Redistribution is permitted only on the License plan, and figures and source citations must not be altered.

aiSwingX™ analyzes US filings and reports them as news investors can read.
33 0