Tether · OpenAPI Overlay 1.0.0

API Evangelist enhancements for the Tether WDK Indexer API

11 actions 11 updates servers extends openapi/tether-wdk-indexer-openapi-original.yml
Generated by API Evangelist Written by API Evangelist tooling for Tether's API. It is a proposal applied on top of the contract, not a document Tether publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

operationIdx-apievangelist-rate-limitserversx-apievangelist-sourcex-apievangelist-docsx-apievangelist-auth

Targets 11

$
$.info
$.paths['/api/v1/health'].get
$.paths['/api/v1/chains'].get
$.paths['/api/v1/keys'].get
$.paths['/api/v1/keys'].post
$.paths['/api/v1/keys/{hashedKey}'].delete
$.paths['/api/v1/{blockchain}/{token}/{address}/token-transfers'].get
$.paths['/api/v1/{blockchain}/{token}/{address}/token-balances'].get
$.paths['/api/v1/batch/token-transfers'].post
$.paths['/api/v1/batch/token-balances'].post

OpenAPI Overlay

Raw ↑
overlay: 1.0.0
info:
  title: API Evangelist enhancements for the Tether WDK Indexer API
  version: 1.0.0
extends: openapi/tether-wdk-indexer-openapi-original.yml
x-apievangelist:
  generated: '2026-08-05'
  method: generated
  source: openapi/tether-wdk-indexer-openapi-original.yml
  rationale: >-
    The harvested spec is real and well-described at the operation level (every
    operation has a summary, a description, tags and typed 2xx/4xx responses) but it
    omits two things a machine consumer needs: a `servers[]` block (the base URL is
    only stated in prose on the docs site) and `operationId` on all nine operations.
    This overlay records the API Evangelist additions without mutating the harvested
    original. The operationIds below are OUR assignment, not the provider's — they
    are used by mcp/tether-tool-crosswalk.yml, errors/, data-model/ and skills/ so
    those artifacts can reference operations by a stable name.
actions:
- target: $
  update:
    servers:
    - url: https://wdk-api.tether.io
      description: Production (documented at https://docs.wdk.tether.io/tools/indexer-api/api-reference)
- target: $.info
  update:
    x-apievangelist-source: https://wdk-api.tether.io/docs/json
    x-apievangelist-docs: https://docs.wdk.tether.io/tools/indexer-api
    x-apievangelist-auth: X-API-KEY header, free key via https://wdk-api.tether.io/register
- target: $.paths['/api/v1/health'].get
  update:
    operationId: getHealth
    x-apievangelist-rate-limit: 10 requests / 1 hour
- target: $.paths['/api/v1/chains'].get
  update:
    operationId: listChains
    x-apievangelist-rate-limit: 60 requests / 1 minute
- target: $.paths['/api/v1/keys'].get
  update:
    operationId: listApiKeys
- target: $.paths['/api/v1/keys'].post
  update:
    operationId: createApiKey
- target: $.paths['/api/v1/keys/{hashedKey}'].delete
  update:
    operationId: deleteApiKey
- target: $.paths['/api/v1/{blockchain}/{token}/{address}/token-transfers'].get
  update:
    operationId: getTokenTransfers
    x-apievangelist-rate-limit: 8 requests / 10 seconds
- target: $.paths['/api/v1/{blockchain}/{token}/{address}/token-balances'].get
  update:
    operationId: getTokenBalances
    x-apievangelist-rate-limit: 4 requests / 10 seconds
- target: $.paths['/api/v1/batch/token-transfers'].post
  update:
    operationId: batchTokenTransfers
    x-apievangelist-rate-limit: 8 requests / 10 seconds
- target: $.paths['/api/v1/batch/token-balances'].post
  update:
    operationId: batchTokenBalances
    x-apievangelist-rate-limit: 4 requests / 10 seconds