> ## 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.

# Discovery and account

> Five free operations that let a cold-start agent teach itself the entire API before spending a credit

The cold-start problem, solved: an agent with no key and no credits can learn
this entire API from the API itself. Five operations cost zero data credits:
`docs`, `schema`, `resolve`, `coverage`, and `usage`. `docs` and `schema` need
no key at all; `resolve`, `coverage`, and `usage` authenticate with a personal
key but still cost nothing.

## docs

Returns the contract guide as markdown. This is the manual, written for both
humans and agents, and it is keyless, so a cold-start agent can read it before
it has anything.

The `section` parameter selects one section and defaults to `index`. Values
are `index`, `quickstart`, `domains`, `access`, `grammar`, `refusals`,
`resolve`, `errors`, `pricing`, `examples`, and `changelog`. The response is
raw markdown with no JSON envelope.

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

## schema

Returns one operation's machine contract: parameters, defaults, enums, and
error set as structured JSON. Keyless. The optional `resource` parameter names
one of the 23 operations; omit it to get the index of all operations.

```bash theme={null}
curl 'https://noxint.ai/api/v1/schema?resource=funding'
```

`docs` plus `schema` is a complete self-teaching loop. Point an agent at the
base URL and it can bootstrap the whole surface, no SDK, no scraped docs, no
human in the loop.

## resolve

Turns a human query into canonical asset IDs with ranked evidence. Call it
once to convert a symbol like `btc` or `apple` into the permanent ID you then
pass to paid operations. Requires a key, costs nothing.

<ParamField query="q" type="string" required>
  The search query. 1 to 80 characters.
</ParamField>

<ParamField query="limit" type="integer" default="10">
  Maximum matches to return per plane. 1 to 25.
</ParamField>

<ParamField query="network" type="string">
  Narrows results to one network.
</ParamField>

The response carries `query`, a `best` match (which may be null), a `matches`
array, and a `coverage` object. When a symbol is contested, a warning names
the collision, for example `symbol_collides_with_covered_equity`. Ticker
ambiguity is surfaced, never silently resolved wrong.

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

## coverage

Lists the assets Noxint knows, or inspects one asset in detail. Requires a
key, costs nothing.

Pass `id` to inspect a single asset. To browse instead, omit `id` and use the
filters: `plane` (`crypto` or `equity`), `tier`, `alive`, `cursor`, and
`limit` (default 100, up to 500). The `id` form and the filter form are
mutually exclusive. Tier values are `core`, `listed_token`, `contract_token`,
`equity`, `full`, `prices_only`, and `discovery_only`.

```bash theme={null}
curl -H 'Authorization: Bearer nx_your_key' \
  'https://noxint.ai/api/v1/coverage?plane=crypto&tier=core&limit=50'
```

## usage

Reports your remaining data credits and your rate-limit window. Takes no
parameters, costs nothing. Because MCP calls cannot re-poll with a conditional
header, `usage` is how an agent checks its own balance between calls: spend
awareness is part of the surface, not an afterthought.

The response carries `credits_remaining` and a `rate_limit` object with
`limit`, `remaining`, and an ISO-8601 `reset_at`.

```bash theme={null}
curl -H 'Authorization: Bearer nx_your_key' \
  'https://noxint.ai/api/v1/usage'
```

<Note>
  All five operations cost zero data credits. They still spend a rate unit, so
  they count against the 60-rate-unit-per-minute personal-key limit.
</Note>