> ## Documentation Index
> Fetch the complete documentation index at: https://staging-docs.crosspoint.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction to Cost Insights

> Track costs, profits, and customer lifetime value with event-based cost tracking

![](https://mintcdn.com/crosspoint/UQs51vKfpD2N4tlw/assets/features/cost/ingestion.light.png?fit=max\&auto=format\&n=UQs51vKfpD2N4tlw\&q=85\&s=aad5ce7b80fbefe2718811985a8356f9)

Cost Insights is a powerful feature that enables you to calculate business-centric metrics like Costs, Profits, and Customer Lifetime Value (LTV) by annotating your events with cost data.

## Overview

While Crosspoint automatically tracks revenue from orders and subscriptions, Cost Insights allows you to track the costs associated with delivering your product or service. By combining revenue and cost data, you can gain deep insights into profitability on a per-customer basis.

## How It Works

Cost Insights works in three simple steps:

1. **Ingest events with cost data**: Add a `_cost` property to events metadata when ingesting them through Crosspoint's Event Ingestion API
2. **Automatic aggregation**: Crosspoint automatically aggregates costs alongside your revenue data
3. **Query and analyze**: Use the Metrics API, or the Crosspoint Dashboard to retrieve costs, profits, and customer LTV

### Quick Example

```json theme={null}
{
  "events": [
    {
      "name": "llm.inference",
      "external_customer_id": "user_123",
      "metadata": {
        "_cost": {
          "amount": 0.025, // $0.00025 in cents
          "currency": "usd"
        }
      }
    }
  ]
}
```

## Common Use Cases

* **AI/LLM Applications**: Track the cost of API calls to OpenAI, Anthropic, or other LLM providers
* **Infrastructure Costs**: Monitor compute, storage, or bandwidth costs per customer
* **Third-Party Services**: Track costs from email providers, SMS gateways, or other external services
* **Customer Profitability**: Calculate profit margins and LTV for each customer

## Documentation

> **[Cost Events](https://staging-docs.crosspoint.finance/features/cost-insights/cost-events.md)**
>
> Learn how to track costs by adding the `_cost` property to your events metadata

> **[Cost Metrics](https://staging-docs.crosspoint.finance/features/analytics.md)**
>
> Query and analyze costs, profits, and customer lifetime value


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.