BLOBPEDIA CIPs API

Celestia Improvement Proposals

Operations 9

GET /api/v1/cips List CIPs with optional filters #
GET /api/v1/cips/{id} Single CIP with full content #
GET /api/v1/cips/{id}/history Status transition history for a CIP #
GET /api/v1/cips/{id}/attachments File attachments (PDFs, signed votes) #
GET /api/v1/cips/{id}/tldr Cached 2-3 sentence TL;DR (no LLM cost) #
GET /api/v1/cips/{id}/mentions Backlinks: forum, blog, sibling CIPs #
GET /api/v1/cips/tldrs Batch cached TL;DRs (up to 50 ids) #
POST /api/v1/cips/batch Bulk CIP lookup (up to 50 ids) #
GET /api/v1/cips/graph requires-dependency graph (nodes + edges) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/blobpedia-org:blobpedia-org-cips-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

blobpedia-org-cips-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: BLOBPEDIA REST CIPs API
  version: 1.0.0
  summary: Celestia knowledge base - machine-readable access
  description: 'Public, unauthenticated REST API over the BLOBPEDIA corpus: CIPs, documentation, forum threads, whitepapers, blog posts, videos, ecosystem projects, GitHub items, releases, on-chain network state, market data, and the RAG embedding index. Same data the website renders; same search engine the website uses (lib/search.ts unifiedSearch).'
  contact:
    name: Unity Nodes
    url: https://unitynodes.com
  license:
    name: MIT
servers:
- url: https://blobpedia.org
  description: production
tags:
- name: CIPs
  description: Celestia Improvement Proposals
paths:
  /api/v1/cips:
    get:
      tags:
      - CIPs
      summary: List CIPs with optional filters
      parameters:
      - name: status
        in: query
        schema:
          type: string
          enum:
          - Draft
          - Review
          - Final
          - Withdrawn
          - Rejected
          - Superseded
      - name: type
        in: query
        schema:
          type: string
      - name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 20
      - name: offset
        in: query
        schema:
          type: integer
          minimum: 0
          default: 0
      responses:
        '200':
          description: Paginated CIP list
      operationId: getApiV1Cips
      x-operation-id-source: derived
  /api/v1/cips/{id}:
    get:
      tags:
      - CIPs
      summary: Single CIP with full content
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          pattern: ^(\d{1,4}|CIP-\d{1,4}|cip-\d{1,4}|PR-\d+)$
      responses:
        '200':
          description: CIP row + url
        '400':
          description: Bad request - invalid path / query param
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
      operationId: getApiV1CipsById
      x-operation-id-source: derived
  /api/v1/cips/{id}/history:
    get:
      tags:
      - CIPs
      summary: Status transition history for a CIP
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          pattern: ^(\d{1,4}|CIP-\d{1,4}|cip-\d{1,4}|PR-\d+)$
      responses:
        '200':
          description: Status change events sorted DESC
        '400':
          description: Bad request - invalid path / query param
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
      operationId: getApiV1CipsByIdHistory
      x-operation-id-source: derived
  /api/v1/cips/{id}/attachments:
    get:
      tags:
      - CIPs
      summary: File attachments (PDFs, signed votes)
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          pattern: ^(\d{1,4}|CIP-\d{1,4}|cip-\d{1,4}|PR-\d+)$
      responses:
        '200':
          description: Attachment list
        '400':
          description: Bad request - invalid path / query param
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
      operationId: getApiV1CipsByIdAttachments
      x-operation-id-source: derived
  /api/v1/cips/{id}/tldr:
    get:
      tags:
      - CIPs
      summary: Cached 2-3 sentence TL;DR (no LLM cost)
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          pattern: ^(\d{1,4}|CIP-\d{1,4}|cip-\d{1,4}|PR-\d+)$
      responses:
        '200':
          description: TLDR (may be null if not yet generated)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CipTldr'
        '400':
          description: Bad request - invalid path / query param
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
      operationId: getApiV1CipsByIdTldr
      x-operation-id-source: derived
  /api/v1/cips/{id}/mentions:
    get:
      tags:
      - CIPs
      summary: 'Backlinks: forum, blog, sibling CIPs'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          pattern: ^(\d{1,4}|CIP-\d{1,4}|cip-\d{1,4}|PR-\d+)$
      responses:
        '200':
          description: Mention aggregates with counts subobject
        '400':
          description: Bad request - invalid path / query param
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
      operationId: getApiV1CipsByIdMentions
      x-operation-id-source: derived
  /api/v1/cips/tldrs:
    get:
      tags:
      - CIPs
      summary: Batch cached TL;DRs (up to 50 ids)
      parameters:
      - name: ids
        in: query
        required: true
        schema:
          type: string
        description: Comma-separated id list, max 50
      responses:
        '200':
          description: Items in input order with nulls for misses
        '400':
          description: Bad request - invalid path / query param
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
      operationId: getApiV1CipsTldrs
      x-operation-id-source: derived
  /api/v1/cips/batch:
    post:
      tags:
      - CIPs
      summary: Bulk CIP lookup (up to 50 ids)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - ids
              properties:
                ids:
                  type: array
                  items:
                    type: string
                  maxItems: 50
      responses:
        '200':
          description: Items in input order
        '400':
          description: Bad request - invalid path / query param
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
      operationId: postApiV1CipsBatch
      x-operation-id-source: derived
  /api/v1/cips/graph:
    get:
      tags:
      - CIPs
      summary: requires-dependency graph (nodes + edges)
      responses:
        '200':
          description: Graph payload
      operationId: getApiV1CipsGraph
      x-operation-id-source: derived
components:
  schemas:
    CipTldr:
      type: object
      properties:
        id:
          type: string
          example: '0042'
        title:
          type: string
        tldr:
          type:
          - string
          - 'null'
        cached:
          type: boolean
        generated_at:
          type:
          - string
          - 'null'
          format: date-time
        url:
          type: string
          format: uri
externalDocs:
  description: /for-ai - human-readable endpoint catalog and MCP integration guide
  url: https://blobpedia.org/for-ai