# Felixcloutier — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Look up detailed x86/amd64 instruction information including opcodes, pseudocode operations, and exceptions, and search by instruction name or summary to understand how processor instructions work. Browse the complete instruction index or get comprehensive documentation for any specific assembly instruction.

**Category:** Developer Tools | **Website:** [felixcloutier.com/](https://felixcloutier.com/) | **Docs:** [parse.bot/marketplace/5a42d23a-bf31-4ebe-be63-2f10fea6f24e/felixcloutier-com-api](https://parse.bot/marketplace/5a42d23a-bf31-4ebe-be63-2f10fea6f24e/felixcloutier-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/felixcloutier/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get instruction detail

Fetches the complete reference documentation for a single x86 instruction identified by mnemonic. Returns structured data including the opcode table, operand encoding, prose description, operation pseudocode, flags affected, compiler intrinsics (when available), and processor exception tables (protected, real, v8086, compatibility, 64-bit modes). A separate round-trip per instruction; use the index or search endpoints to discover valid mnemonics first.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `mnemonic` | string | Yes | Instruction mnemonic, case-insensitive (e.g. ADD, MOV, IMUL, VADDPD). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/felixcloutier/get-instruction-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"mnemonic":"<string>"}'
```

### Get instruction index

Retrieves the complete index of x86/amd64 instructions. Each entry contains the mnemonic, a brief summary of what the instruction does, and the URL path to its detail page. The index is a single-page static list (no pagination).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/felixcloutier/get-instruction-index \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get instruction opcodes

Retrieves only the opcode encoding table for a specific instruction. Each row describes one encoding variant with opcode bytes, assembly syntax, operand encoding type, 64-bit mode validity, compatibility/legacy mode validity, and a prose description. A lighter alternative to get_instruction_detail when only encoding information is needed.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `mnemonic` | string | Yes | Instruction mnemonic, case-insensitive (e.g. MOV, ADD, IMUL, VADDPD). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/felixcloutier/get-instruction-opcodes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"mnemonic":"<string>"}'
```

### Search instructions by mnemonic

Filters the instruction index to entries whose mnemonic contains the query string (case-insensitive substring match). Returns the same shape as the index endpoint but limited to matches. Useful for discovering instruction families (e.g. query 'ADD' returns ADD, ADDPD, ADDPS, ADDSD, etc.).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Mnemonic search term, case-insensitive substring (e.g. ADD, MOV, MUL). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/felixcloutier/search-instructions-by-mnemonic \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### Search instructions by summary

Filters the instruction index to entries whose summary description contains the query string (case-insensitive substring match). Useful for finding instructions by what they do (e.g. query 'multiply' returns MUL, IMUL, FMUL, etc.).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Summary search term, case-insensitive substring (e.g. multiply, compare, shift, packed). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/felixcloutier/search-instructions-by-summary \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.