CoinRebate Link Evidence API

openapi: 3.2.0
info:
  title: CoinRebate Fee Optimization Link Evidence API
  description: 'Free, open API for querying crypto exchange fee data and compliance-filtered recommendations. No authentication is required. Breaking changes follow the published 90-day deprecation policy: https://www.coinrebate.vip/en/developers#deprecation'
  version: 4.1.0
  contact:
    name: CoinRebate
    url: https://www.coinrebate.vip/en/contact
    email: support@coinrebate.vip
  license:
    name: Free to use
    url: https://www.coinrebate.vip/for-agents
servers:
- url: https://www.coinrebate.vip
  description: Production
tags:
- name: Link Evidence
paths:
  /api/v4/link-evidence:
    get:
      operationId: inspectExchangeLink
      summary: inspect_exchange_link
      description: 'Inspects an exchange sign-up or referral link and reports evidence on five separate points: whether the domain is a verified official domain of a listed exchange, whether it is reachable, whose referral code it carries, how CoinRebate''s records list the exchange for a given country, and what rebate (if any) is configured. Unknown items are reported as unknown. It never says a link is safe, never probes unrecognized domains, and never suggests a replacement link. Read-only.'
      parameters:
      - name: url
        in: query
        required: true
        schema:
          type: string
          format: uri
      - name: country
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: link-evidence/1
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LinkEvidenceResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
      tags:
      - Link Evidence
components:
  responses:
    BadRequest:
      description: Invalid request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            invalidCountry:
              summary: Unassigned country code
              value:
                error: Invalid country. Expected an assigned ISO 3166-1 alpha-2 code.
                code: invalid_country
                docs: https://www.coinrebate.vip/openapi.json
            invalidPurpose:
              summary: Unsupported trading purpose
              value:
                error: Invalid purpose. Expected 'spot' or 'futures'.
                code: invalid_purpose
                docs: https://www.coinrebate.vip/openapi.json
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    InternalError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    RateLimited:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    LinkEvidenceResponse:
      type: object
      properties:
        schema:
          type: string
          enum:
          - link-evidence/1
        observed_at:
          type: string
        input:
          type: object
          properties:
            host:
              type: string
            registrable_domain:
              type:
              - string
              - 'null'
          required:
          - host
          - registrable_domain
          additionalProperties: false
        exchange:
          type:
          - string
          - 'null'
        domain_identity:
          type: object
          properties:
            status:
              type: string
              enum:
              - official
              - configured_mirror
              - unrecognized
            lookalike_of:
              type:
              - string
              - 'null'
            basis:
              type: string
            evidence_date:
              type:
              - string
              - 'null'
          required:
          - status
          - lookalike_of
          - basis
          - evidence_date
          additionalProperties: false
        reachability:
          type: object
          properties:
            status:
              type: string
              enum:
              - ok
              - waf_challenge
              - failed
              - not_probed
            http_status:
              type:
              - number
              - 'null'
            final_host:
              type:
              - string
              - 'null'
            ends_on_official_domain:
              type:
              - boolean
              - 'null'
          required:
          - status
          - http_status
          - final_host
          - ends_on_official_domain
          additionalProperties: false
        referral_code:
          type: object
          properties:
            status:
              type: string
              enum:
              - coinrebate_current
              - coinrebate_retired
              - third_party_unverified
              - absent
              - ambiguous
              - not_checked
            survives_redirect:
              type:
              - boolean
              - 'null'
          required:
          - status
          - survives_redirect
          additionalProperties: false
        regional_policy:
          type: object
          properties:
            status:
              type: string
              enum:
              - listed_available
              - listed_restricted
              - unknown
            country:
              type:
              - string
              - 'null'
            reviewed_at:
              type:
              - string
              - 'null'
          required:
          - status
          - country
          - reviewed_at
          additionalProperties: false
        benefit:
          type: object
          properties:
            status:
              type: string
              enum:
              - configured
              - unknown
            rate:
              type:
              - number
              - 'null'
            conditions:
              type: array
              items:
                type: string
          required:
          - status
          - rate
          - conditions
          additionalProperties: false
        summary:
          type: string
        summary_cn:
          type: string
        next_steps:
          type: array
          items:
            type: string
        next_steps_cn:
          type: array
          items:
            type: string
        disclosure:
          type: string
      required:
      - schema
      - observed_at
      - input
      - exchange
      - domain_identity
      - reachability
      - referral_code
      - regional_policy
      - benefit
      - summary
      - summary_cn
      - next_steps
      - next_steps_cn
      - disclosure
      additionalProperties: false
    Error:
      type: object
      required:
      - error
      - code
      properties:
        error:
          type: string
        code:
          type: string
        docs:
          type: string
          format: uri