Equibles
Purpose
Read-only US stock market data from Equibles: search SEC filings and earnings call transcripts and read the exact numbered lines behind an answer, pull income, balance sheet and cash-flow statements from SEC XBRL, look up a quarter's earnings call, Form 4 insider transactions, 13F institutional holders, congressional trades and daily end-of-day prices. Use it when the user asks what a company said in a filing or on a call, how its financials moved, or who has been buying or selling the stock.
Source: the public OpenAPI spec at https://api.equibles.com/openapi/v1.json and the REST reference at https://equibles.com/docs/api, both checked on 2026-10-19. Equibles also runs a hosted MCP server for MCP clients (https://equibles.com/mcp); this skill uses the REST API.
Tooling
All commands go through bin/equibles.py. Each prints the API's JSON response unchanged.
bin/equibles.py status # GET /v1/market/status, plus which auth mode is in use
bin/equibles.py search "artificial intelligence risk" --ticker JPM --type 10-K --limit 2 # GET /v1/stocks/JPM/filings/search
bin/equibles.py search "tariff impact on gross margin" --limit 5 # GET /v1/filings/search across all companies
bin/equibles.py lines 5bdbf4fd-c262-45e0-a91f-6576a3957ce1 238 240 # GET /v1/filings/{documentId}/lines
bin/equibles.py statement AAPL income --year 2025 --period FY # GET /v1/stocks/AAPL/financial-statements/income
bin/equibles.py call NVDA 2026 2 # GET /v1/stocks/NVDA/earnings-calls/2026/2
bin/equibles.py insiders NVDA --type Buy --limit 10 # GET /v1/stocks/NVDA/insider-transactions
bin/equibles.py holders NVDA --limit 10 # GET /v1/stocks/NVDA/institutional-holders
bin/equibles.py congress --ticker NVDA --type Purchase --limit 10 # GET /v1/congress/trades
bin/equibles.py prices AAPL --start 2026-09-01 --end 2026-09-30 # GET /v1/stocks/AAPL/prices
search returns excerpts with a documentId and startLineNumber; pass them to lines to quote the surrounding text (at most 500 lines per call). statement takes income, balance or cashflow; omit --year and --period for the latest period. --limit is 1-100 everywhere.
Auth
- Provider id:
equibles (credential is collected as custom.equibles)
- Collection: API key via the secure credential flow (
credentials.request_api_access). Users create a key at https://equibles.com/dashboard/apikeys. Outside Muse, the CLI reads the key from the EQUIBLES_API_KEY environment variable. It never accepts a key as an argument.
- Connect placement:
bearer_header (Authorization: Bearer <key>; the key is never put in the query string)
- Required scopes: none; the API has no scopes. Access depends on the key's plan: the free plan allows 100 requests a day across MCP and REST, and paid plans start at $9.99 a month (https://equibles.com/pricing).
- Allowed hosts:
api.equibles.com (HTTPS only; redirects to any other host are refused)
- Status check:
bin/equibles.py status. Every endpoint needs a key; a missing or deleted key returns HTTP 401 unauthorized.
Operating Rules
- This connector is read-only: every call is a GET. It never places trades, edits a portfolio or watchlist, or sends anything on the user's behalf.
- Each command is one API request and counts toward the key's daily allowance. Prefer one targeted
search plus lines over many broad searches.
- When quoting a filing or transcript, cite the company, form, filed date and line numbers from the response, and read the lines with
lines before quoting.
- Insider rows carry
transactionCode and isOpenMarketTrade; gifts, awards, tax withholding and exercises are not open-market buys or sells, so check those fields before describing a trade.
- Congressional trade amounts are the disclosed STOCK Act value bands, not exact figures;
filingDate is when the trade became public.
- Report HTTP errors verbatim (401
unauthorized, 429 when the daily allowance is used up). A 401 means the key is missing or invalid, not that the data is missing.
- Present results as data, not investment advice. Never print, log, or transmit the key value.
Files
Maturity
🧪 Draft: every command (status, search with and without --ticker, lines, statement, call, insiders, holders, congress, prices) was live-tested against api.equibles.com on 2026-10-19 with a temporary key on a paid plan, as was the 401 path for an invalid key. The free-plan allowance and the Muse credential flow have not been tested end-to-end.
1---2name: "equibles"3description: "US stock research data: SEC filing and earnings call search with line-level reads, XBRL financial statements, earnings calls, Form 4 insider trades, 13F holders, congressional trades and daily prices. Read-only. Trigger phrases: equibles, sec filing, 10-k, earnings call, insider trades, 13f holders, congress trades, income statement."4metadata:5 source: https://skillmd.com/skills/anil-matcha/equibles6 includeInPrompt: true7tagline: "SEC filings and transcripts with line-level citations, XBRL statements, insider, 13F and congressional trades, daily prices. Read-only; free plan 100 requests a day."8catalog_auth: "Equibles API key (per-user, free plan available)"9catalog_hosts: ["api.equibles.com"]10---1112# Equibles1314## Purpose15Read-only US stock market data from [Equibles](https://equibles.com): search SEC filings and earnings call transcripts and read the exact numbered lines behind an answer, pull income, balance sheet and cash-flow statements from SEC XBRL, look up a quarter's earnings call, Form 4 insider transactions, 13F institutional holders, congressional trades and daily end-of-day prices. Use it when the user asks what a company said in a filing or on a call, how its financials moved, or who has been buying or selling the stock.1617Source: the public OpenAPI spec at https://api.equibles.com/openapi/v1.json and the REST reference at https://equibles.com/docs/api, both checked on 2026-10-19. Equibles also runs a hosted MCP server for MCP clients (https://equibles.com/mcp); this skill uses the REST API.1819## Tooling20All commands go through `bin/equibles.py`. Each prints the API's JSON response unchanged.2122```bash23bin/equibles.py status # GET /v1/market/status, plus which auth mode is in use24bin/equibles.py search "artificial intelligence risk" --ticker JPM --type 10-K --limit 2 # GET /v1/stocks/JPM/filings/search25bin/equibles.py search "tariff impact on gross margin" --limit 5 # GET /v1/filings/search across all companies26bin/equibles.py lines 5bdbf4fd-c262-45e0-a91f-6576a3957ce1 238 240 # GET /v1/filings/{documentId}/lines27bin/equibles.py statement AAPL income --year 2025 --period FY # GET /v1/stocks/AAPL/financial-statements/income28bin/equibles.py call NVDA 2026 2 # GET /v1/stocks/NVDA/earnings-calls/2026/229bin/equibles.py insiders NVDA --type Buy --limit 10 # GET /v1/stocks/NVDA/insider-transactions30bin/equibles.py holders NVDA --limit 10 # GET /v1/stocks/NVDA/institutional-holders31bin/equibles.py congress --ticker NVDA --type Purchase --limit 10 # GET /v1/congress/trades32bin/equibles.py prices AAPL --start 2026-09-01 --end 2026-09-30 # GET /v1/stocks/AAPL/prices33```3435`search` returns excerpts with a `documentId` and `startLineNumber`; pass them to `lines` to quote the surrounding text (at most 500 lines per call). `statement` takes `income`, `balance` or `cashflow`; omit `--year` and `--period` for the latest period. `--limit` is 1-100 everywhere.3637## Auth38- Provider id: `equibles` (credential is collected as `custom.equibles`)39- Collection: API key via the secure credential flow (`credentials.request_api_access`). Users create a key at https://equibles.com/dashboard/apikeys. Outside Muse, the CLI reads the key from the `EQUIBLES_API_KEY` environment variable. It never accepts a key as an argument.40- Connect placement: `bearer_header` (`Authorization: Bearer <key>`; the key is never put in the query string)41- Required scopes: none; the API has no scopes. Access depends on the key's plan: the free plan allows 100 requests a day across MCP and REST, and paid plans start at $9.99 a month (https://equibles.com/pricing).42- Allowed hosts: `api.equibles.com` (HTTPS only; redirects to any other host are refused)43- Status check: `bin/equibles.py status`. Every endpoint needs a key; a missing or deleted key returns HTTP 401 `unauthorized`.4445## Operating Rules461. This connector is read-only: every call is a GET. It never places trades, edits a portfolio or watchlist, or sends anything on the user's behalf.472. Each command is one API request and counts toward the key's daily allowance. Prefer one targeted `search` plus `lines` over many broad searches.483. When quoting a filing or transcript, cite the company, form, filed date and line numbers from the response, and read the lines with `lines` before quoting.494. Insider rows carry `transactionCode` and `isOpenMarketTrade`; gifts, awards, tax withholding and exercises are not open-market buys or sells, so check those fields before describing a trade.505. Congressional trade amounts are the disclosed STOCK Act value bands, not exact figures; `filingDate` is when the trade became public.516. Report HTTP errors verbatim (401 `unauthorized`, 429 when the daily allowance is used up). A 401 means the key is missing or invalid, not that the data is missing.527. Present results as data, not investment advice. Never print, log, or transmit the key value.5354## Files55- SKILL.md56- bin/equibles.py5758## Maturity59🧪 Draft: every command (`status`, `search` with and without `--ticker`, `lines`, `statement`, `call`, `insiders`, `holders`, `congress`, `prices`) was live-tested against api.equibles.com on 2026-10-19 with a temporary key on a paid plan, as was the 401 path for an invalid key. The free-plan allowance and the Muse credential flow have not been tested end-to-end.