---
title: "Buy 1 hour of Coil Live with a wallet instead of a subscription"
method: POST
path: "/api/live/session"
tags: ["Market Data"]
---

# Buy 1 hour of Coil Live with a wallet instead of a subscription

`POST /api/live/session`

## Request

- Base URL: `https://coil.trade`
- URL: `https://coil.trade/api/live/session`
- Auth: one of:
  - API key in header `X-PAYMENT`
  - HTTP payment

Mints a time-boxed Coil Live session token in exchange for an x402 payment. The token goes wherever a subscription license goes — header X-License-Key — and unlocks every *_live MCP tool plus get_engine_feed and get_live_rules, and the /api/live/* HTTP routes. The token is issued ONLY in the settled response; an unpaid call returns HTTP 402 with the terms. Sessions do not auto-renew. More than about 196 session-hours a month costs more than Coil Live ($49/mo) — subscribe if you run daily, buy a session for burst use.

## Headers

- `PAYMENT-SIGNATURE` string
- `X-PAYMENT` string
- `Authorization` string
- `X-Coil-Key` string
- `SIGN-IN-WITH-X` string

## Response `200`

A Coil Live session token, minted on settlement. Carries session_token, expires_at, duration_hours and the list of what it unlocks. Send the token as X-License-Key to open every *_live MCP tool plus get_engine_feed and get_live_rules, and the /api/live/* HTTP routes, for 6 hours. Issued ONLY in the settled response — an unpaid call returns 402 with the terms and no token.

- object

## Other responses

- `402`: Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header

---

[API](https://skmtc.dev/coil/apis/coil-scanner-agent-api.md) · [All operations](https://skmtc.dev/coil/apis/coil-scanner-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coil/apis/coil-scanner-agent-api/revisions/e087ee004cfb?raw)