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

# Dollar credits

> Free, temporary and bought dollar credits, and the order they are spent in.

Datacircle sells dollar credits: \$1 buys 1 dollar credit, and every call spends them at the provider's price, no markup.

```bash theme={null}
curl https://idle.api.datacircle.dev/dollar-credits/ -H "Authorization: Token $DATACIRCLE_API_KEY"
```

```json theme={null}
{
  "dollar_credits_remaining": 5.0,
  "signup_dollar_credits": 5.0,
  "bought_dollar_credits": 0.0,
  "manual_dollar_credits": 0.0,
  "temporary": [],
  "coop_file_unlocked": false
}
```

## Kinds of dollar credits

* **Signup:** 5 dollar credits, permanent, once per workspace.
* **Temporary:** from a campaign. The launch campaign adds 20 dollar credits, usable for 24 hours, to every workspace created since the campaign opened on its first authenticated call in launch week (the 7 days after launch; a `GET /dollar-credits/` counts, so the 24 hours start then), while the launch budget of 1,000 dollar credits lasts. It is listed in `temporary` with its `expires_at`; whatever is left then is gone.
* **Bought:** through Stripe Checkout, permanent.
* **Manual:** added to your workspace by Datacircle by hand (a refund, a gift, a deal), permanent.

Every field is explained in the API reference: Datacircle, Read the balance.

## Spend order

Each call spends temporary dollar credits first (soonest to expire), then the signup dollar credits, then bought and manual dollar credits (oldest first). So free dollar credits never sit unused while you pay.

## Buying dollar credits

Buy any whole number of dollar credits from 5 to 10,000 from your dashboard, or from the API: it returns a Stripe payment page to open or hand to a human.

```bash theme={null}
curl -X POST https://idle.api.datacircle.dev/checkout/ -H "Authorization: Token $DATACIRCLE_API_KEY" \
  -H "Content-Type: application/json" -d '{"dollar_credits": 50}'
```

```json theme={null}
{ "checkout_url": "https://checkout.stripe.com/c/pay/..." }
```

The dollar credits land as soon as Stripe confirms the payment. Everyone who buys 50 dollar credits (in total) unlocks the co-op file (`coop`), a new one every day, for the foreseeable future (see [Files](/files)). Free dollar credits never count toward it.


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