Coil Trade Authentication

generated: '2026-11-04'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://coil.trade/auth.md
sources:
- https://coil.trade/auth.md
- https://coil.trade/agents/quickstart
description: Authentication methods for Coil API as documented on auth.md and quickstart pages.
schemes:
- type: apiKey
  name: Free API key
  evidence: Free API key | `api_key` | free (email registration) | `X-Coil-Key`
  location: header
  header: X-Coil-Key
  how_to_obtain: POST https://coil.trade/api/key with an email address; response includes a "key" to use as X-Coil-Key.
- type: apiKey
  name: Wallet sign‑in (SIWX)
  evidence: Wallet sign-in (SIWX) | signed message (no funds move) | free | `SIGN-IN-WITH-X`
  location: header
  header: SIGN-IN-WITH-X
  how_to_obtain: Obtain a nonce via GET https://coil.trade/api/auth/nonce?address=... then sign the message and send the base64 signature in the
    SIGN-IN-WITH-X header.
- type: http-bearer
  name: OAuth bearer (client_credentials)
  evidence: 'OAuth bearer | `client_credentials` → JWT | included with the license key | `Authorization: Bearer`'
  location: header
  header: Authorization
  scopes:
  - board:live
  how_to_obtain: POST https://coil.trade/oauth/token with grant_type=client_credentials, client_id=my-agent, client_secret=YOUR-LICENSE-KEY; response
    includes access_token.
- type: other
  name: x402 payment
  evidence: x402 payment | none (signed payment) | $0.001–$0.25/read, plus a $0.25 one‑hour Live session
  how_to_obtain: When a request returns HTTP 402 with a PAYMENT-REQUIRED header, sign the listed payment option with a wallet holding USDC and
    resend the request with PAYMENT-SIGNATURE.
note: Anonymous access requires no authentication and is not represented as a scheme. 2 extracted row(s) were dropped because their quote was
  not on the page.
docs: https://coil.trade/auth.md