CoinGraph Watch API

Get told when something changes.

Operations 3

POST /monitor Watch tokens and receive webhooks #
GET /monitor List your monitors #
DELETE /monitor/{id} Stop a monitor #

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/coingraph-ai:coingraph-ai-watch-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

coingraph-ai-watch-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: CoinGraph Watch API
  version: 1.0.0
  summary: 'Provable crypto data for AI agents: market, on-chain, whale, contract and sanctions data in one call.'
  description: 'Humans read it, agents call it. Every response carries where the data came from (sources) and when it was true (as_of); anything unmeasured is "unassessed". CoinGraph never executes, custodies or advises — the caller decides.


    Phase: hackathon. Discover and Trust calls are free. Data calls (state, history, market) are free for 25 calls a day, then 1 credit. Premium calls (sized checks, fresh briefs, questions, address lookups, monitors, most agents) are 5 credits; Pro agents are 25. With an API key, calls spend credits; without one, paid calls answer 402 with x402 payment details.'
  contact:
    name: CoinGraph
    url: https://coingraph.ai
    email: support@coingraph.ai
  x-mcp-server: https://coingraph.ai/mcp
servers:
- url: https://coingraph.ai/api/v1
  description: Production
tags:
- name: Watch
  description: Get told when something changes.
paths:
  /monitor:
    post:
      tags:
      - Watch
      operationId: monitorCreate
      summary: Watch tokens and receive webhooks
      description: We POST to your webhook when a signal fires, a verdict changes or a new brief is written. Webhooks are signed (X-CoinGraph-Signature, HMAC-SHA256 with your secret). **Premium tier:** 10 free calls a day, then 5 credits per call with an API key, or pay per call with x402 (402 Payment Required → pay → retry with PAYMENT-SIGNATURE). Needs a paid plan (403 plan_required on the Free plan).
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MonitorRequest'
      responses:
        '201':
          description: Monitor
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    type: string
                    const: monitor
                  id:
                    type:
                    - string
                    - 'null'
                  as_of:
                    type: string
                    format: date-time
                  data:
                    $ref: '#/components/schemas/Monitor'
                  sources:
                    type: array
                    items:
                      $ref: '#/components/schemas/Source'
                required:
                - object
                - as_of
                - data
                - sources
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
      - apiKey: []
      - partner: []
      - x402: []
    get:
      tags:
      - Watch
      operationId: monitorList
      summary: List your monitors
      parameters:
      - name: X-Monitor-Secret
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Monitors
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    type: string
                    const: monitor_list
                  id:
                    type:
                    - string
                    - 'null'
                  as_of:
                    type: string
                    format: date-time
                  data:
                    $ref: '#/components/schemas/MonitorList'
                  sources:
                    type: array
                    items:
                      $ref: '#/components/schemas/Source'
                required:
                - object
                - as_of
                - data
                - sources
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /monitor/{id}:
    delete:
      tags:
      - Watch
      operationId: monitorDelete
      summary: Stop a monitor
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: X-Monitor-Secret
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Monitor
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    type: string
                    const: monitor
                  id:
                    type:
                    - string
                    - 'null'
                  as_of:
                    type: string
                    format: date-time
                  data:
                    $ref: '#/components/schemas/Monitor'
                  sources:
                    type: array
                    items:
                      $ref: '#/components/schemas/Source'
                required:
                - object
                - as_of
                - data
                - sources
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    MonitorRequest:
      type: object
      properties:
        tokens:
          type: array
          items:
            type: string
        webhook_url:
          type: string
          format: uri
        conditions:
          type: object
          properties:
            kinds:
              type: array
              items:
                type: string
            min_severity:
              type: integer
              minimum: 1
              maximum: 3
            verdict_changes:
              type: boolean
            new_briefs:
              type: boolean
      required:
      - tokens
      - webhook_url
    MonitorList:
      type: object
      additionalProperties: true
    Source:
      type: object
      properties:
        provider:
          type: string
        endpoint:
          type: string
        as_of:
          type:
          - string
          - 'null'
          format: date-time
    Monitor:
      type: object
      additionalProperties: true
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
  securitySchemes:
    x402:
      type: apiKey
      in: header
      name: PAYMENT-SIGNATURE
      description: x402 v2 payment (signed Cardano transaction, base64). Paid endpoints answer 402 with a PAYMENT-REQUIRED header describing the payment.
    apiKey:
      type: http
      scheme: bearer
      description: Account API key (cg_live_…) from https://coingraph.ai/account/keys. Paid calls spend credits (data 1, premium 5, pro 25; 1,000 free a month) instead of an x402 payment; responses carry x-credits-charged and x-credits-remaining. 401 invalid_key, 402 out_of_credits.
    partner:
      type: http
      scheme: bearer
      description: 'Design-partner key (cg_…) issued by hand: used instead of paying per call.'