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

# ETF Detail

> Retrieve full details for a single NGX-listed ETF or ETP.

This endpoint returns comprehensive information for a specific NGX-listed ETF or ETP. The response includes the full fund profile — ISIN, fund manager, index tracked, trustee, custodian, and liquidity provider — alongside the latest OHLCV snapshot, 52-week price range, average 3-month volume, and period change percentages.

Symbols are case-insensitive. This endpoint requires a Starter plan or higher.


## OpenAPI

````yaml GET /etfs/{symbol}
openapi: 3.1.0
info:
  title: NGN Market API
  version: '1.0'
  description: >
    The NGN Market API provides programmatic access to Nigerian Exchange Group
    (NGX) market data, including equities, forex rates, company profiles,
    indices, bonds, and financial news.


    ## Base URL


    All endpoints are served from:


    ```

    https://api.ngnmarket.com/v1

    ```


    ## Authentication


    Every request requires a Bearer token in the `Authorization` header:


    ```

    Authorization: Bearer ngm_live_YOUR_KEY

    ```


    Generate and manage your API keys from the [developer
    dashboard](https://ngnmarket.com/developer).


    ## Plans & Quotas


    | Plan | Monthly Calls | Requests/min | Price |

    | :--- | ---: | ---: | :--- |

    | Free | 3,000 | 30 | Free |

    | Hobby | 10,000 | 60 | ₦15,000/mo |

    | Starter | 100,000 | 120 | ₦50,000/mo |

    | Growth | 500,000 | 200 | ₦200,000/mo |

    | Business | 2,000,000 | 300 | ₦700,000/mo |

    | Enterprise | Unlimited | Unlimited | Custom |


    Every response includes a `meta` object showing your current usage and
    remaining quota. Exceeding the per-minute rate limit returns `429
    RATE_LIMITED`. Exceeding the monthly quota returns `429 QUOTA_EXCEEDED`.


    ## Response Envelope


    All responses use a consistent JSON envelope:


    ```json

    {
      "success": true,
      "data": { ... },
      "meta": {
        "plan": "starter",
        "calls_used": 4821,
        "calls_remaining": 95179,
        "reset_at": "2026-05-01T00:00:00.000Z"
      }
    }

    ```
  contact:
    name: NGN Market Support
    email: support@ngnmarket.com
    url: https://ngnmarket.com
  license:
    name: Proprietary
servers:
  - url: https://api.ngnmarket.com/v1
    description: Production
security:
  - BearerAuth: []
tags:
  - name: Market
    description: >-
      Daily market snapshots, top trades, movers, market breadth, sectors, and
      YTD performers.
  - name: Companies
    description: >-
      Browse, search, and retrieve profiles, price charts, and financial
      statements for NGX-listed companies.
  - name: Forex
    description: Current and historical NGN exchange rates against major currencies.
  - name: Indices
    description: >-
      All NGX market indices, including list, detail with constituents, and
      historical chart data.
  - name: ETFs
    description: >-
      NGX-listed Exchange Traded Funds and ETPs — list, full fund detail, and
      historical daily price data.
  - name: Bonds
    description: >-
      NGX-listed bond instruments with issuer details, coupon rates, and
      maturity dates.
  - name: Disclosures
    description: >-
      Official corporate filings from NGX-listed companies (financial
      statements, AGM notices, board meetings, director dealings, earnings
      forecasts). Sourced from NGX Group and updated twice daily.
  - name: Blog
    description: >-
      Published NGN Market blog posts. List, search, and filter by category or
      company.
  - name: Dividends
    description: >-
      Market-wide NGX dividend calendar. Browse upcoming and recently paid
      dividends across all listed companies with optional search and pagination.
  - name: Account
    description: >-
      Quota status, 30-day request analytics, and paginated request logs for the
      authenticated user.
paths:
  /etfs/{symbol}:
    get:
      tags:
        - ETFs
      summary: ETF detail and fund profile
      description: >
        Returns comprehensive information for a specific NGX-listed ETF or ETP,
        including the full fund profile (ISIN, fund manager, index tracked,
        trustee, custodian, liquidity provider, website), the latest OHLCV
        snapshot, 52-week price range, average 3-month volume, and period change
        percentages.


        **Plan required:** Starter
      operationId: getETFDetail
      parameters:
        - name: symbol
          in: path
          description: ETF ticker symbol (e.g. `STANBICETF30`). Case-insensitive.
          required: true
          schema:
            type: string
            example: STANBICETF30
      responses:
        '200':
          description: ETF detail retrieved successfully.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/SuccessEnvelope'
                  - type: object
                    properties:
                      data:
                        $ref: '#/components/schemas/ETFDetail'
              examples:
                stanbicetf30:
                  summary: STANBICETF30 detail
                  value:
                    success: true
                    data:
                      symbol: STANBICETF30
                      isin: NGSTBKETF308
                      name: STANBIC IBTC ETF 30
                      fund_manager: Stanbic IBTC Asset Management Limited
                      index_tracked: NSE 30
                      fund_sponsor: Stanbic IBTC Stockbrokers Limited
                      trustee: FBN Trustees Limited
                      custodian: UBA Plc (Global Investor Services Division)
                      liquidity_provider: Stanbic IBTC Stockbrokers Limited
                      website: null
                      current_price: 4175
                      prev_close: 4330
                      price_change: -155
                      price_change_percent: -3.47
                      open_price: 4330
                      day_high: 4350
                      day_low: 3911.5
                      volume: 3961
                      value_traded: 16361032.94
                      high_52wk: 7003.96
                      low_52wk: 295.3
                      avg_vol_3m: 32
                      change_7d_percent: null
                      change_ytd_percent: null
                      change_52w_percent: null
                      latest_date: '2026-06-10'
                      stats_date: '2026-06-10'
                    meta:
                      plan: hobby
                      calls_used: 142
                      calls_remaining: 9858
                      reset_at: '2026-07-01T00:00:00.000Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/PlanRequired'
        '404':
          description: ETF not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              example:
                success: false
                error:
                  code: NOT_FOUND
                  message: ETF 'UNKNOWN' not found.
        '429':
          $ref: '#/components/responses/QuotaExceeded'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  schemas:
    SuccessEnvelope:
      type: object
      required:
        - success
      properties:
        success:
          type: boolean
          const: true
        meta:
          $ref: '#/components/schemas/Meta'
    ETFDetail:
      allOf:
        - $ref: '#/components/schemas/ETFSummary'
        - type: object
          properties:
            fund_sponsor:
              type: string
              nullable: true
              example: Stanbic IBTC Stockbrokers Limited
            trustee:
              type: string
              nullable: true
              example: FBN Trustees Limited
            custodian:
              type: string
              nullable: true
              example: UBA Plc (Global Investor Services Division)
            liquidity_provider:
              type: string
              nullable: true
              example: Stanbic IBTC Stockbrokers Limited
            website:
              type: string
              nullable: true
              example: null
            open_price:
              type: number
              nullable: true
              description: Day's opening price from the latest trading session.
              example: 4330
            day_high:
              type: number
              nullable: true
              example: 4350
            day_low:
              type: number
              nullable: true
              example: 3911.5
            latest_date:
              type: string
              format: date
              nullable: true
              description: Trade date of the latest OHLCV snapshot.
              example: '2026-06-10'
    ErrorEnvelope:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          const: false
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              description: Machine-readable error identifier.
              example: NOT_FOUND
            message:
              type: string
              description: Human-readable error description.
              example: Resource not found.
            required_plan:
              type: string
              description: _(PLAN_REQUIRED only)_ Minimum plan needed.
            current_plan:
              type: string
              description: _(PLAN_REQUIRED only)_ Your current plan.
    Meta:
      type: object
      description: Quota and plan metadata included on every authenticated response.
      properties:
        plan:
          type: string
          description: Current plan name.
          enum:
            - free
            - starter
            - growth
            - business
            - enterprise
          example: starter
        calls_used:
          type: integer
          description: Total calls made this calendar month across all your keys.
          example: 4821
        calls_remaining:
          type: integer
          description: Calls remaining before your quota is exhausted.
          example: 95179
        reset_at:
          type: string
          format: date-time
          description: ISO 8601 UTC timestamp of your next quota reset (1st of next month).
          example: '2026-05-01T00:00:00.000Z'
    ETFSummary:
      type: object
      properties:
        symbol:
          type: string
          example: STANBICETF30
        isin:
          type: string
          nullable: true
          example: NGSTBKETF308
        name:
          type: string
          example: STANBIC IBTC ETF 30
        fund_manager:
          type: string
          nullable: true
          example: Stanbic IBTC Asset Management Limited
        index_tracked:
          type: string
          nullable: true
          example: NSE 30
        current_price:
          type: number
          nullable: true
          example: 4175
        prev_close:
          type: number
          nullable: true
          example: 4330
        price_change:
          type: number
          nullable: true
          example: -155
        price_change_percent:
          type: number
          nullable: true
          example: -3.47
        change_7d_percent:
          type: number
          nullable: true
          example: 2.14
        change_ytd_percent:
          type: number
          nullable: true
          example: null
        change_52w_percent:
          type: number
          nullable: true
          example: null
        volume:
          type: integer
          nullable: true
          description: Today's traded volume (units).
          example: 3961
        value_traded:
          type: number
          nullable: true
          description: Today's naira value traded.
          example: 16361032.94
        avg_vol_3m:
          type: integer
          nullable: true
          description: Average daily volume over the last 3 months.
          example: 32
        high_52wk:
          type: number
          nullable: true
          example: 7003.96
        low_52wk:
          type: number
          nullable: true
          example: 295.3
        stats_date:
          type: string
          format: date
          nullable: true
          example: '2026-06-10'
  responses:
    Unauthorized:
      description: Missing or invalid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
          examples:
            missingKey:
              summary: Missing Authorization header
              value:
                success: false
                error:
                  code: MISSING_API_KEY
                  message: 'Provide your API key via: Authorization: Bearer <key>'
            invalidKey:
              summary: Invalid or revoked key
              value:
                success: false
                error:
                  code: INVALID_API_KEY
                  message: API key not found or revoked.
    PlanRequired:
      description: Endpoint requires a higher plan.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
          example:
            success: false
            error:
              code: PLAN_REQUIRED
              message: This endpoint requires a starter plan or higher.
              required_plan: starter
              current_plan: free
    QuotaExceeded:
      description: Monthly call limit reached.
      content:
        application/json:
          schema:
            allOf:
              - $ref: '#/components/schemas/ErrorEnvelope'
              - type: object
                properties:
                  meta:
                    $ref: '#/components/schemas/Meta'
          example:
            success: false
            error:
              code: QUOTA_EXCEEDED
              message: >-
                Monthly call limit of 100,000 reached. Resets on
                2026-05-01T00:00:00.000Z.
            meta:
              plan: starter
              calls_used: 100000
              calls_remaining: 0
              reset_at: '2026-05-01T00:00:00.000Z'
    ServerError:
      description: Unexpected server-side failure. Safe to retry with backoff.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
          example:
            success: false
            error:
              code: SERVER_ERROR
              message: Something went wrong on our end. Please try again.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: ngm_live_*
      description: >
        Pass your API key as a Bearer token: `Authorization: Bearer
        ngm_live_YOUR_KEY`.

        Generate keys at
        [ngnmarket.com/dashboard/developer](https://ngnmarket.com/developer).

````