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

# API quickstart

> Your agent's first market read is one GET away: personal keys, data credits, and a first normalized call

<Note>
  This is not vaporware documentation. The API and MCP server run in production
  today, serving the chat analyst every answer it gives. Public access opens in
  beta after launch: key minting and credit packs open with the beta. This page
  documents the live contract. [Launch status](/token/status) tracks what is on
  today.
</Note>

The Noxint data API serves the same engine that answers the chat analyst,
direct and unfiltered. Every call is one GET request to
`https://noxint.ai/api/v1`, authenticated with a personal key and priced per
delivered result. No SDK required, no OAuth dance, no per-venue adapters.

Here is a complete first call. It reads the current price of Bitcoin.

```bash theme={null}
curl -H 'Authorization: Bearer nx_your_key' \
  'https://noxint.ai/api/v1/price?id=crypto:bitcoin'
```

A trimmed response:

```json theme={null}
{
  "data": {
    "asset_id": "crypto:bitcoin",
    "headline": {
      "usd": 62719.1,
      "return_24h_pct": { "value": 1.8, "pctl": 61 },
      "range_pos_7d_pct": 74.2
    }
  }
}
```

Notice the shape: the 24-hour return arrives with its own percentile. That is
the whole point of this API. Numbers land pre-ranked against their own
history, so your agent reasons instead of guessing. The full spec is the
[data contract](/data/contract).

## Get set up

This is the flow once the API beta opens.

<Steps>
  <Step title="Sign in and open the console">
    Go to [noxint.ai](https://noxint.ai), sign in with your wallet, and open
    the console at [/dashboard](https://noxint.ai/dashboard). Any signed-in
    account will be able to mint a key. No token balance required: the agent
    lane is not gated on \$NOXINT.
  </Step>

  <Step title="Mint a personal key">
    Create a personal key from the console. It starts with `nx_` and is shown
    once, at creation. Noxint stores only a hash, so a lost key cannot be
    recovered, only replaced. Up to 5 active keys per account.
  </Step>

  <Step title="Fund data credits">
    Data credits pay for delivered results. Credit packs open in the console
    with the beta and fund your key. Data credits are separate from chat
    credits and from Holder flow.
  </Step>

  <Step title="Make your first call">
    Send the `price` request above with your key in the `Authorization`
    header. The `X-Credits-Charged` response header reports exactly what the
    call cost. No surprise bills, ever.
  </Step>
</Steps>

## Explore before you spend

The API teaches itself. The root, `docs`, and `schema` operations are keyless,
so a cold-start agent (or you, right now) can read the entire contract with no
key and no credits.

```bash theme={null}
curl 'https://noxint.ai/api/v1/docs?section=quickstart'
```

The `resolve`, `coverage`, and `usage` operations require a key but cost zero
credits. `resolve` turns a ticker into a canonical asset ID, `coverage` lists
what is available, and `usage` reports your credits and rate limit. Nothing
bills until real market data is delivered.

See the [operations overview](/api/operations/overview) for the full set of
23 operations.