ExchangeRebel Listing Check 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: Listing Check
paths:
  /toll/listing-check:
    get:
      tags:
      - Listing Check
      summary: Listing Check service catalog
      responses:
        '200':
          description: 'Success. Returns the service catalog: what each listing check includes, the price ($0.02 per op, all four ops), the published criteria (listing-consistency/v1) and its grading rules, the pinned test corpus, and the scope statement (each op grades exactly what it names; no composite score).'
      security: []
      operationId: getTollListingCheck
      x-operation-id-source: derived
  /toll/listing-check/health:
    get:
      tags:
      - Listing Check
      summary: Listing Check service health
      responses:
        '200':
          description: Success. Returns service liveness and the report signer address.
      security: []
      operationId: getTollListingCheckHealth
      x-operation-id-source: derived
  /toll/listing-check/criteria:
    get:
      tags:
      - Listing Check
      summary: The published listing-consistency criteria
      responses:
        '200':
          description: 'Success. Returns the full published criteria (listing-consistency/v1): the four ops'' grading rules (check, example, promise, bazaar), and the pinned public test corpus identity; every report is reproducible from them.'
      security: []
      operationId: getTollListingCheckCriteria
      x-operation-id-source: derived
  /toll/listing-check/corpus:
    get:
      tags:
      - Listing Check
      summary: The pinned public test corpus identity
      responses:
        '200':
          description: 'Success. Returns the public test corpus identity for listing checks: corpus id listing-consistency-corpus/v1 and its SHA-256 pin 7b78aeb01be7868c59ea985f41588c2b991f2c82d4cb04505e6fec497ef200b1 (the SHA-256 of the corpus''s canonical serialization, verifiable with the published harness). The corpus is buyer-runnable before paying.'
      security: []
      operationId: getTollListingCheckCorpus
      x-operation-id-source: derived
  /toll/listing-check/precheck:
    post:
      tags:
      - Listing Check
      summary: Free headline pre-check of one listing submission (fetches nothing)
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                caller:
                  type: string
                  description: Solana base58 wallet of the operator; keys the free allowance (100/day per wallet).
                op:
                  type: string
                listing:
                  type: object
                  description: 'The listing under check, in the op''s published form (check: url, method, network, asset, price_micro; example: example_input + input_schema; promise: max_timeout_seconds + declared_delivery_seconds).'
                payload:
                  type: object
                  description: 'For the bazaar op: the captured payment payload carrying resource + extensions.bazaar.'
                facilitator:
                  type: string
                  description: 'For the bazaar op: the facilitator the payload was captured from (e.g. cdp).'
              required:
              - caller
              - op
      responses:
        '200':
          description: 'Success. Returns assessability only: whether the submission is complete for its op. The free pre-check fetches nothing and returns no grades. A malformed submission is refused free. When the caller''s free allowance is exhausted, the response is the /toll/listing-check payment challenge instead.'
      security: []
      operationId: postTollListingCheckPrecheck
      x-operation-id-source: derived
  /toll/listing-check/check:
    post:
      tags:
      - Listing Check
      summary: Full signed listing-vs-live consistency grade of one listing
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                op:
                  type: string
                listing:
                  type: object
                  description: 'The listing under check, in the op''s published form (check: url, method, network, asset, price_micro; example: example_input + input_schema; promise: max_timeout_seconds + declared_delivery_seconds).'
              required:
              - listing
      responses:
        '200':
          description: 'Success. Returns the full signed report: the listing-vs-live grade: the listing''s url, method, resource, price, asset and network each graded MATCH / MISMATCH / NOT-OBSERVABLE against the live 402 the service fetches from the listing''s own URL, with the outcome state (CONSISTENT / INCONSISTENT / PARTIALLY-OBSERVABLE / UNREACHABLE), and an as-of timestamp.'
        '402':
          description: 'Payment Required (x402). A per-item fee: $0.02 per op - each submitted listing is charged at $0.02; the payment includes one listing-consistency grade of the submitted material under listing-consistency/v1, every factor graded and printed, exactly as specified in the service criteria. The response body carries the payment instructions in x402 v1 form: payTo (the operator''s Solana wallet), the amount (20000 USDC units = $0.02 per op) and a fresh memo. 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: fixed
          currency: USD
          amount: '0.02'
      security:
      - x402Payment: []
      operationId: postTollListingCheckCheck
      x-operation-id-source: derived
  /toll/listing-check/example:
    post:
      tags:
      - Listing Check
      summary: Full signed example-validity grade of one listing's example input
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                op:
                  type: string
                listing:
                  type: object
                  description: 'The listing under check, in the op''s published form (check: url, method, network, asset, price_micro; example: example_input + input_schema; promise: max_timeout_seconds + declared_delivery_seconds).'
              required:
              - listing
      responses:
        '200':
          description: 'Success. Returns the full signed report: the example-validity grade: every field of the listing''s example_input graded against its declared input_schema (PRESENT / TYPE-MATCH / violations named), with the outcome state, and an as-of timestamp.'
        '402':
          description: 'Payment Required (x402). A per-item fee: $0.02 per op - each submitted listing is charged at $0.02; the payment includes one listing-consistency grade of the submitted material under listing-consistency/v1, every factor graded and printed, exactly as specified in the service criteria. The response body carries the payment instructions in x402 v1 form: payTo (the operator''s Solana wallet), the amount (20000 USDC units = $0.02 per op) and a fresh memo. 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: fixed
          currency: USD
          amount: '0.02'
      security:
      - x402Payment: []
      operationId: postTollListingCheckExample
      x-operation-id-source: derived
  /toll/listing-check/promise:
    post:
      tags:
      - Listing Check
      summary: Full signed promise-consistency grade of one listing's timeout promise
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                op:
                  type: string
                listing:
                  type: object
                  description: 'The listing under check, in the op''s published form (check: url, method, network, asset, price_micro; example: example_input + input_schema; promise: max_timeout_seconds + declared_delivery_seconds).'
              required:
              - listing
      responses:
        '200':
          description: 'Success. Returns the full signed report: the promise-consistency grade: the declared delivery time graded against the quoted maxTimeoutSeconds, with the margin printed and the outcome state, and an as-of timestamp.'
        '402':
          description: 'Payment Required (x402). A per-item fee: $0.02 per op - each submitted listing is charged at $0.02; the payment includes one listing-consistency grade of the submitted material under listing-consistency/v1, every factor graded and printed, exactly as specified in the service criteria. The response body carries the payment instructions in x402 v1 form: payTo (the operator''s Solana wallet), the amount (20000 USDC units = $0.02 per op) and a fresh memo. 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: fixed
          currency: USD
          amount: '0.02'
      security:
      - x402Payment: []
      operationId: postTollListingCheckPromise
      x-operation-id-source: derived
  /toll/listing-check/bazaar:
    post:
      tags:
      - Listing Check
      summary: Full signed bazaar-echo completeness grade of one captured payment payload
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                op:
                  type: string
                facilitator:
                  type: string
                  description: 'For the bazaar op: the facilitator the payload was captured from (e.g. cdp).'
                payload:
                  type: object
                  description: 'For the bazaar op: the captured payment payload carrying resource + extensions.bazaar.'
              required:
              - payload
      responses:
        '200':
          description: 'Success. Returns the full signed report: the bazaar-echo grade: resource and extensions.bazaar presence graded field by field, with the outcome state (COMPLETE / INCOMPLETE), and an as-of timestamp.'
        '402':
          description: 'Payment Required (x402). A per-item fee: $0.02 per op - each submitted listing is charged at $0.02; the payment includes one listing-consistency grade of the submitted material under listing-consistency/v1, every factor graded and printed, exactly as specified in the service criteria. The response body carries the payment instructions in x402 v1 form: payTo (the operator''s Solana wallet), the amount (20000 USDC units = $0.02 per op) and a fresh memo. 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: fixed
          currency: USD
          amount: '0.02'
      security:
      - x402Payment: []
      operationId: postTollListingCheckBazaar
      x-operation-id-source: derived
  /toll/listing-check/metrics:
    get:
      tags:
      - Listing Check
      summary: Listing 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 listings.
      security: []
      operationId: getTollListingCheckMetrics
      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.'