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

# Install the agent skill

> Install the NGN Market skill so your coding agent knows when and how to use the correct API endpoints.

The NGN Market skill teaches your coding agent how to use the NGN Market API without being told each time.

The skill file is hosted at [`docs.ngnmarket.com/skill.md`](https://docs.ngnmarket.com/skill.md).

Once installed, your agent will be able to:

* Look up live and historical NGX equities, indices, ETFs, and bond data
* Fetch OHLCV price history and render it as a candlestick or line chart correctly
* Convert between NGN and other currencies using live forex rates
* Pull dividend calendars, corporate disclosures, and company fundamentals
* Know which plan tier (free through enterprise) an endpoint requires before recommending it

## Prerequisites

* **An NGN Market API key.** Sign up at [ngnmarket.com](https://ngnmarket.com), copy the key from your [developer dashboard](https://ngnmarket.com/developer) (prefix `ngm_live_`), and export it in the shell your agent inherits so the skill can read it:

  ```bash theme={null}
  # Add to your shell profile or .env — never commit it.
  export NGNMARKET_API_KEY="ngm_live_..."
  ```

  For a single project, drop it in `.env.local` and have the agent load that file before each run.
* **A supported agent.** Claude Code, Cursor, Windsurf, Codex, OpenCode, and other agents that read skill files.
* **Node.js** to run the `npx skills` installer (or install manually with `curl`).

## Installation

### Method 1: Skills CLI (one command, every agent)

The skills CLI detects your agent and drops the skill in the directory that agent reads. One command covers every supported agent:

```bash theme={null}
npx skills add -g https://docs.ngnmarket.com/skill.md
```

Drop the `-g` to install into the current project instead of globally.

### Method 2: Manual install with `curl`

Pick your client below and run the matching `curl`. Use the project commands for an in-repo skill, or the global commands for a cross-project skill that lives in your home directory.

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={null}
    # Project
    mkdir -p .claude/skills/ngnmarket
    curl -fsSL https://docs.ngnmarket.com/skill.md -o .claude/skills/ngnmarket/SKILL.md

    # Global (across all projects)
    mkdir -p ~/.claude/skills/ngnmarket
    curl -fsSL https://docs.ngnmarket.com/skill.md -o ~/.claude/skills/ngnmarket/SKILL.md
    ```
  </Tab>

  <Tab title="Cursor">
    ```bash theme={null}
    # Project
    mkdir -p .agents/skills/ngnmarket
    curl -fsSL https://docs.ngnmarket.com/skill.md -o .agents/skills/ngnmarket/SKILL.md

    # Global
    mkdir -p ~/.cursor/skills/ngnmarket
    curl -fsSL https://docs.ngnmarket.com/skill.md -o ~/.cursor/skills/ngnmarket/SKILL.md
    ```
  </Tab>

  <Tab title="Windsurf">
    ```bash theme={null}
    # Project
    mkdir -p .windsurf/skills/ngnmarket
    curl -fsSL https://docs.ngnmarket.com/skill.md -o .windsurf/skills/ngnmarket/SKILL.md

    # Global
    mkdir -p ~/.codeium/windsurf/skills/ngnmarket
    curl -fsSL https://docs.ngnmarket.com/skill.md -o ~/.codeium/windsurf/skills/ngnmarket/SKILL.md
    ```
  </Tab>

  <Tab title="Any agent (.agents)">
    Codex, OpenCode, Gemini CLI, GitHub Copilot, Cline, and other agents share the `.agents/skills/` directory:

    ```bash theme={null}
    mkdir -p .agents/skills/ngnmarket
    curl -fsSL https://docs.ngnmarket.com/skill.md -o .agents/skills/ngnmarket/SKILL.md
    ```
  </Tab>
</Tabs>

## Verify it loaded

Open a fresh agent session and ask:

> "Using the NGN Market API, what endpoint and plan tier do I need to get a candlestick chart for DANGCEM?"

A correctly loaded skill answers `GET /companies/{symbol}/chart?format=ohlcv` and notes it requires the **Hobby** plan. If the agent invents a different endpoint or gets the tier wrong, the skill didn't load — confirm the file exists at the path your agent reads and that nothing else is shadowing it.

## Next steps

<CardGroup cols={2}>
  <Card title="Agent quickstart" icon="magnifying-glass" href="/agent-quickstart">
    Pair the skill with a copyable, repo-scanning agent prompt.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/introduction">
    Every endpoint, parameter, and response schema.
  </Card>

  <Card title="Guides" icon="book-open" href="/guides/live-price-ticker">
    Worked examples for the most common integrations.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    API key formats, security best practices, and error handling.
  </Card>
</CardGroup>