Coattail
Sign up

Developer API · Invite-only beta

Build something
worth knowing.

Bring Coattail’s investor disclosures and stock intelligence into your own tools.

  • Power a research dashboard, script, or workflow.
  • Get structured data with dates and available source links.
  • Start with one API key and a simple request.
Get API access ↗See how it works

From an idea to your first request.

  1. Get beta access

    Sign in to Coattail and request access for what you’re building.

  2. Create your key

    Name your API key in the developer dashboard. Save it somewhere private.

    API base address
    https://pro.coattail.co/api/v1

  3. Make a request

    Send the key in the Authorization header. Use the example below to start.

Your first request

A little code.
A useful answer.

Set COATTAIL_API_KEY to your private key, then run this in your terminal.

Use API keys on your server, never in public browser code. Access is limited to the datasets enabled for your beta account.

cURL
curl 'https://pro.coattail.co/api/v1/investors?query=Pelosi' \
  -H "Authorization: Bearer $COATTAIL_API_KEY"

Start with research.

Clear, read-only endpoints. No live pricing or trading setup needed.

Download API reference ↗
Parameters, limits, and common responses

/investors?query=Pelosi returns up to 12 investor matches. Use /disclosures?ticker=NVDA or ?investor_id=house_nancy_pelosi for up to six disclosures.

/intel?ticker=NVDA&type=earnings returns up to six stored records. Types: contracts, lobbying, short, fda, darkpool, earnings. Use offset from 0 to 120 and follow pagination fields.

All keys for one API account share 60 requests per minute and four requests at a time. Keys expire after 30 days. Responses are previews, not complete histories. Customer API limits are separate from MCP connection limits. There is no monthly credit system during beta.

401: check your key. 403: the dataset needs access. 429: wait before retrying. 503: try again later. Authentication, errors, and keys are never included in shared caches. Full reference.

Just want to ask a question?

Connect Coattail to your AI Agent instead.

Explore Coattail MCP ↗