Skip to main content

Countercyclical

Countercyclical is an end-to-end investment research and due diligence platform built for modern investment teams. The platform helps analysts and portfolio managers move from asset discovery to allocation by surfacing investment opportunities across 70,000+ publicly traded assets. Countercyclical centralizes the entire research workflow — from initial screening and fundamental analysis through full valuation modeling and memo writing — into a single, collaborative environment. Key capabilities include structured investment tracking, prebuilt and custom valuation templates, and rich investment memos with version history and collaborative annotations. Enterprise customers can access Countercyclical data programmatically via a REST API and webhook integrations, enabling organizations to synchronize investment research data — including Investments, Valuations, and Memos — with external data warehouses, analytics platforms, and downstream systems.

Countercyclical icon

Power end-to-end data operations for your Countercyclical API with Nexla. Our bi-directional Countercyclical connector is purpose-built for Countercyclical, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Countercyclical or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Countercyclical workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

  • Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
  • Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
  • API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
  • Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites

Countercyclical's REST API is available to Enterprise plan customers. Before creating a Countercyclical credential in Nexla, you will need an active Countercyclical Enterprise account and an API key generated from your workspace settings.

Countercyclical Account and Plan Requirements

  1. Ensure your organization has an active Countercyclical Enterprise subscription. API access is an Enterprise feature and is not available on standard plans.

  2. If your organization does not yet have an Enterprise subscription, contact the Countercyclical sales team at enterprise@countercyclical.io or visit countercyclical.com to request an enterprise demo and upgrade your plan.

Generate a Countercyclical API Key

Countercyclical API keys are generated from the Settings area of your workspace. Each API key grants programmatic access to your workspace's investment research data, so it should be stored securely and treated like a password.

  1. Sign in to your Countercyclical account at dashboard.countercyclical.io.

  2. Navigate to Settings in the left-hand navigation panel.

  3. Open the Workspace settings section and select the Advanced tab.

  4. Locate the Access or API Keys section. Click the Generate API Key (or New Access Token) button to create a new key.

  5. Give your API key a descriptive name — for example, "Nexla Integration" — so it can be easily identified and managed later.

  6. Copy the generated API key immediately and store it in a secure location (such as a password manager). For security reasons, Countercyclical will not display the full key again after you navigate away from this page.

For complete information about API access and key management, refer to the Countercyclical developer documentation.

Important

Treat your Countercyclical API key like a password. Do not share it publicly or commit it to source control. If a key is compromised, revoke it immediately from your workspace settings and generate a new one.

Authenticate

Create a credential in Nexla

  1. After selecting the data source type, click the Add Credential tile to open the Add New Credential overlay.

  2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

  3. Enter the Countercyclical API key you generated in the prerequisite steps into the API Key field. This key authenticates Nexla with the Countercyclical API and authorizes access to your workspace's investment research data.

    The API key is sent as a Bearer token in the Authorization header of all API requests made by Nexla. Ensure the key belongs to a user account that has appropriate access to the Investments, Valuations, and Memos data you intend to ingest.

  4. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source creation and can be selected for use with a new data source.

Use as a data source

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Countercyclical connector tile, then select the credential that will be used to connect to your Countercyclical workspace, and click Next; or, create a new Countercyclical credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from the core Countercyclical data streams. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

Investments

This endpoint retrieves the investment records in your Countercyclical workspace. Each investment represents an asset that you or your team is tracking or appraising. Use this endpoint to ingest your full investment list — including asset names, identifiers, status, and associated metadata — for analysis, reporting, or downstream distribution.

  • This endpoint automatically retrieves all investments accessible within the authenticated workspace. No additional configuration is required beyond selecting this endpoint template.
  • The endpoint uses pagination to handle large datasets efficiently, automatically fetching additional pages of results as needed.
  • Each investment record includes fields such as the asset name, ticker symbol, asset class, current status, and timestamps for creation and last update.

The Investments stream returns the core investment tracking data from your Countercyclical workspace. To retrieve associated valuation models or research memos for specific investments, use the Valuations or Memos endpoint templates.

Valuations

This endpoint retrieves the valuation models associated with investments in your Countercyclical workspace. Valuations contain the financial modeling data produced by your team's analysis, including prebuilt and custom templates. Use this endpoint when you need to ingest valuation outputs — such as intrinsic value estimates, discount rate assumptions, and financial projections — for reporting or further analysis.

  • This endpoint automatically retrieves all valuations accessible within the authenticated workspace. No additional parameter configuration is required beyond selecting this endpoint template.
  • Each valuation record includes fields such as the associated investment, valuation methodology, key financial assumptions, calculated outputs, and version information.
  • Countercyclical supports multiple valuation templates per investment. All versions are returned by this endpoint, allowing you to track valuation history over time.

Valuations are linked to specific investments in Countercyclical. You can join Valuation records to Investment records using the investment identifier present in each valuation record.

Memos

This endpoint retrieves the investment memos stored in your Countercyclical workspace. Memos capture structured investment theses, due diligence notes, and ongoing insights — providing a living record of your team's research thinking with rich context, version history, and collaborative annotations. Use this endpoint to ingest memo content for archival, compliance, or downstream knowledge management purposes.

  • This endpoint automatically retrieves all memos accessible within the authenticated workspace. No additional parameter configuration is required beyond selecting this endpoint template.
  • Each memo record includes fields such as the associated investment, memo title, author, content body, version history, and timestamps for creation and last update.
  • Countercyclical maintains a full version history for each memo. All versions are returned by this endpoint, enabling you to track how your team's research thesis has evolved over time.

Memos are linked to specific investments in Countercyclical. You can join Memo records to Investment records using the investment identifier present in each memo record. For additional information about Countercyclical's memo structure, refer to the Countercyclical documentation.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration

Countercyclical data sources can also be manually configured to ingest data from any valid Countercyclical API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

The Countercyclical API base URL follows the pattern https://api.countercyclical.io/v1/, with common endpoint paths including https://api.countercyclical.io/v1/investments, https://api.countercyclical.io/v1/valuations, and https://api.countercyclical.io/v1/memos. Countercyclical wraps the relevant records in a top-level data array, so set the path to data to $.data[*]. API access requires an Enterprise plan; refer to the Countercyclical developer documentation for the complete list of available endpoints and their parameters.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new Countercyclical data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.