> ## 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. # Paginated blog post list > Returns a paginated list of published NGN Market blog posts sorted by publication date (newest first). Each page contains up to 20 posts. Filter the feed using any combination of `category`, `company`, and `tag` query parameters. All filters are optional and combinable (e.g. `?category=markets&company=DANGCEM`). **Plan required:** Free ## OpenAPI ````yaml get /blog/posts 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: /blog/posts: get: tags: - Blog summary: Paginated blog post list description: > Returns a paginated list of published NGN Market blog posts sorted by publication date (newest first). Each page contains up to 20 posts. Filter the feed using any combination of `category`, `company`, and `tag` query parameters. All filters are optional and combinable (e.g. `?category=markets&company=DANGCEM`). **Plan required:** Free operationId: getBlogPosts parameters: - name: page in: query description: Page number. Defaults to `1`. required: false schema: type: integer minimum: 1 default: 1 - name: category in: query description: > Filter by category slug. One of: `markets`, `corporate-news`, `economy`, `industries`, `technology`, `personal-finance`, `product-updates`. required: false schema: type: string enum: - markets - corporate-news - economy - industries - technology - personal-finance - product-updates example: markets - name: company in: query description: > Filter by an NGX-listed company's stock ticker symbol, for example `DANGCEM` for Dangote Cement, `MTNN` for MTN Nigeria, or `GTCO` for Guaranty Trust. The lookup is case-insensitive and matches the post's `companies` field exactly, so there is no fuzzy matching. You can fetch the full list of valid symbols from `GET /companies/identifiers`. required: false schema: type: string example: DANGCEM - name: tag in: query description: > Filter by tag slug. One of: `stocks`, `crypto`, `exchange-rate`, `inflation`, `cbn`, `earnings`, `energy`, `banking`, `fintech`, `t-bills`, `fg`, `dividends`, `ngn-market`. required: false schema: type: string enum: - stocks - crypto - exchange-rate - inflation - cbn - earnings - energy - banking - fintech - t-bills - fg - dividends - ngn-market example: banking responses: '200': description: Blog posts retrieved successfully. content: application/json: schema: allOf: - $ref: '#/components/schemas/SuccessEnvelope' - type: object properties: data: type: object properties: data: type: array items: $ref: '#/components/schemas/BlogPost' pagination: $ref: '#/components/schemas/PaginationExtended' examples: blogPosts: summary: First page of blog posts value: success: true data: data: - slug: fgn-bond-market-outlook-2026 title: FGN Bond Market Outlook for 2026 excerpt: >- An in-depth look at Federal Government bond yields and what investors can expect through the rest of 2026. cover_image: >- https://ngnmarket.com/images/blog/fgn-bond-outlook.jpg published_date: '2026-04-10' categories: - economy - fixed-income tags: - bonds - fg companies: [] url: >- https://ngnmarket.com/blog/fgn-bond-market-outlook-2026 - slug: dangote-cement-q1-analysis title: 'Dangote Cement Q1 2026 Results: What the Numbers Say' excerpt: >- A breakdown of Dangote Cement's Q1 2026 financial results and what they mean for shareholders. cover_image: >- https://ngnmarket.com/images/blog/dangote-cement-q1.jpg published_date: '2026-04-07' categories: - corporate-news tags: - earnings companies: - DANGCEM url: >- https://ngnmarket.com/blog/dangote-cement-q1-analysis pagination: page: 1 limit: 20 total: 42 pages: 3 has_next: true has_prev: false meta: plan: free calls_used: 312 calls_remaining: 9688 reset_at: '2026-05-01T00:00:00.000Z' '401': $ref: '#/components/responses/Unauthorized' '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' BlogPost: type: object description: Standard post card returned by the blog list endpoint. properties: slug: type: string title: type: string excerpt: type: string cover_image: type: string description: URL of the cover image, or empty string if none. published_date: type: string format: date categories: type: array items: type: string description: Category slugs for this post. tags: type: array items: type: string companies: type: array items: type: string description: NGX ticker symbols explicitly tagged to this post. url: type: string description: Canonical URL of the post on ngnmarket.com. PaginationExtended: type: object properties: page: type: integer example: 1 limit: type: integer example: 20 total: type: integer example: 42 pages: type: integer example: 3 has_next: type: boolean example: true has_prev: type: boolean example: false 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' 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. 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 ' invalidKey: summary: Invalid or revoked key value: success: false error: code: INVALID_API_KEY message: API key not found or revoked. 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). ````