ExchangeRebel Refcheck API

openapi: 3.2.0
info:
  title: ExchangeRebel — pay-per-call APIs for AI agents (x402 on…
  version: 1.0.0
  contact:
    name: 'ExchangeRebel (operator: Rebel Data)'
    url: https://exchangerebel.com
    email: sound.money.investing@gmail.com
  x-guidance: 'All paid operations use x402 on Solana: call without payment to get a 402 challenge (SOL recipient + USDC token account + fresh memo), pay with the memo attached via the Solana Memo program, then retry with header X-Payment-Tx: <signature> and ?toll_memo=<memo>. Challenges are dual-version: the PAYMENT-REQUIRED header carries the x402 v2 PaymentRequired object and the response body carries the same challenge in x402 v1 form for compatibility. Free operations (security: []) include each service''s /health catalog with full response shapes. Prices in x-payment-info are USD per call unless the summary says otherwise (RPC is per 1,000-request block; Telegram provisioning is per bot-month; transcription is per minute of audio).'
  description: '67 data and utility APIs behind x402 tolls, settled in SOL or USDC on Solana. Call a paid endpoint without payment to receive a 402 x402 challenge (recipient + fresh memo), pay with the memo attached via the Solana Memo program, then retry with the X-Payment-Tx header and toll_memo query parameter. Free catalog/health endpoints are marked without x-payment-info. Full catalogs: GET /toll/discovery and each service''s /health.'
servers:
- url: https://exchangerebel.com
tags:
- name: Refcheck
paths:
  /toll/refcheck:
    get:
      tags:
      - Refcheck
      summary: Reference Check service catalog
      responses:
        '200':
          description: 'Success. Returns the service catalog: what a reference check includes, the prices, and the scope statement (This service verifies that a submitted citation reference resolves in its register and whether the claimed fields match the register''s record. It does not judge whether the cited work supports any claim made about it, and it does not grade the cited work.)'
      security: []
      operationId: getTollRefcheck
      x-operation-id-source: derived
  /toll/refcheck/health:
    get:
      tags:
      - Refcheck
      summary: Reference Check service health
      responses:
        '200':
          description: Success. Returns service liveness and the report signer address.
      security: []
      operationId: getTollRefcheckHealth
      x-operation-id-source: derived
  /toll/refcheck/criteria:
    get:
      tags:
      - Refcheck
      summary: The published reference-resolution criteria
      responses:
        '200':
          description: 'Success. Returns the full published criteria (reference-resolution/v1): identifier forms, type inference, ID normalization, the three register adapters, the title/author/year comparison rules, the verdict vocabulary, the leg switches, and the scope line. Every check is reproducible from them.'
      security: []
      operationId: getTollRefcheckCriteria
      x-operation-id-source: derived
  /toll/refcheck/precheck:
    post:
      tags:
      - Refcheck
      summary: Free headline reference pre-check of one submitted citation reference
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                caller:
                  type: string
                  description: Solana base58 wallet of the caller; keys the free allowance (100/day per wallet).
                reference:
                  description: 'The submitted citation reference: { type?, id, claimed: { title, authors?, year? } }. type is optional (inferred from the id form: PMID, DOI, or arXiv). Submitted content is processed in memory only and never stored.'
              required:
              - caller
              - reference
      responses:
        '200':
          description: 'Success. Returns the signed verdict line only: verdict, identifier type, and register. Field-by-field detail and the register record are in the paid report. When the caller''s free allowance is exhausted, the response is the /toll/refcheck/check payment challenge instead.'
      security: []
      operationId: postTollRefcheckPrecheck
      x-operation-id-source: derived
  /toll/refcheck/check:
    post:
      tags:
      - Refcheck
      summary: Full reference check report for one submitted citation reference
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                reference:
                  description: 'The submitted citation reference: { type?, id, claimed: { title, authors?, year? } }. type is optional (inferred from the id form: PMID, DOI, or arXiv). Submitted content is processed in memory only and never stored.'
                caller:
                  type: string
                  description: Solana base58 wallet of the caller; keys the free allowance (100/day per wallet).
      responses:
        '200':
          description: 'Success. Returns the full signed report: the verdict (RESOLVES-AND-MATCHES / RESOLVES-BUT-DIFFERS / DOES-NOT-RESOLVE / NOT COVERED), field-by-field comparison with the register record relied on, the criteria id, and the signature. Submitted reference content is processed in memory only and never stored.'
        '402':
          description: 'Payment Required (x402). A per-item fee: $0.01 buys one reference check of one submitted citation reference (PMID, DOI, or arXiv). The response body carries the payment instructions in x402 v1 form: payTo (the operator''s Solana wallet), the amount (10000 USDC units = $0.01) and a fresh memo. Pay in USDC on Solana with the memo attached via the Solana Memo program, then resubmit the same check request with the payment transaction in the X-Payment-Tx header and ?toll_memo=<memo>, re-sending the same reference in the request body. The PAYMENT-REQUIRED response header carries the same object in x402 v2 form.'
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
      security:
      - x402Payment: []
      operationId: postTollRefcheckCheck
      x-operation-id-source: derived
  /toll/refcheck/metrics:
    get:
      tags:
      - Refcheck
      summary: Reference Check aggregate counters
      responses:
        '200':
          description: Success. Returns aggregate counters (paid checks, distinct payers, free pre-checks today). Aggregate only — no payer identities, no submitted reference content.
      security: []
      operationId: getTollRefcheckMetrics
      x-operation-id-source: derived
  /toll/refcheck/setprecheck:
    post:
      tags:
      - Refcheck
      summary: 'Free set pre-check: assessability + the exact fee line for a citation set'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                references:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      id:
                        type: string
                      claimed:
                        type: object
                  description: '1 to 25 citation references { type?, id, claimed: { title, authors?, year? } }.'
                caller:
                  type: string
                  description: Solana base58 wallet; required on the free set pre-check only.
              required:
              - references
      responses:
        '200':
          description: 'Success. Returns the headline set pre-check: citation count, the set cap (25), and the exact fee line ($0.01 per citation in the set, naming this set''s size and total). Free within the caller''s daily allowance (100/day, rate-limited).'
      security: []
      operationId: postTollRefcheckSetprecheck
      x-operation-id-source: derived
  /toll/refcheck/setcheck:
    post:
      tags:
      - Refcheck
      summary: Check a set of citations in one report ($0.01 per citation)
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                references:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      id:
                        type: string
                      claimed:
                        type: object
                  description: '1 to 25 citation references { type?, id, claimed: { title, authors?, year? } }.'
                caller:
                  type: string
                  description: Solana base58 wallet; required on the free set pre-check only.
              required:
              - references
      responses:
        '200':
          description: 'Success. Returns the signed set report: a per-citation outcome for every citation in the set — whether it resolves in its register and whether its claimed fields match the register record, with the register record relied on where one is found — graded under reference-resolution-set/v1 against the base criteria (reference-resolution/v1).'
        '402':
          description: 'Payment Required (x402). A per-item fee: $0.01 per citation in the set — the challenge amount is $0.01 multiplied by the number of citations submitted (a 2-citation set is $0.02 = 20000 USDC units; the set cap is 25 citations). The payment includes one set report with a per-citation outcome for every citation in the set. The response body carries the payment instructions in x402 v1 form: payTo (the operator''s Solana wallet), the amount and a fresh memo (prefix ref-check-set-). Pay in USDC on Solana with the memo attached via the Solana Memo program, then resubmit the same request with the payment transaction in the X-Payment-Tx header and ?toll_memo=<memo>, re-sending the request body. The PAYMENT-REQUIRED response header carries the same object in x402 v2 form.'
      x-payment-info:
        protocols:
        - x402
        price:
          mode: per-item
          currency: USD
          amount: '0.01'
          per: citation in the set
      operationId: postTollRefcheckSetcheck
      x-operation-id-source: derived
components:
  securitySchemes:
    x402Payment:
      type: apiKey
      in: header
      name: X-Payment-Tx
      description: 'x402 toll payment proof: the Solana transaction signature of a payment carrying the memo from the 402 challenge; send together with ?toll_memo=<memo>. Payment itself is made on-chain in SOL or USDC to the recipient named in the challenge.'