GoldRush x402 API — Endpoints

naftiko: 1.0.0-alpha2
info:
  label: GoldRush x402 API — Endpoints
  description: Pay-per-request HTTP 402 endpoint directory and x402 data endpoints (balances, recent transactions). Self-contained Naftiko capability for agents handling x402 settlement.
  tags:
  - Covalent
  - GoldRush
  - x402
  - AI Agents
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    GOLDRUSH_API_KEY: GOLDRUSH_API_KEY
capability:
  consumes:
  - type: http
    namespace: x402-endpoints
    baseUri: https://api.covalenthq.com
    description: GoldRush x402 endpoint discovery and pay-per-request data.
    resources:
    - name: list
      path: /v1/x402/endpoints
      operations:
      - { name: listEndpoints, method: GET, description: 'List All Available X402 Endpoints.', outputRawFormat: json }
    - name: search
      path: /v1/x402/endpoints/search
      operations:
      - { name: searchEndpoints, method: GET, description: 'Search X402 Endpoints.', outputRawFormat: json }
    - name: endpoint
      path: /v1/x402/endpoints/{endpointId}
      operations:
      - { name: getEndpoint, method: GET, description: 'Get Details For A Specific X402 Endpoint.', outputRawFormat: json }
    - name: balances
      path: /v1/x402/{chainName}/address/{walletAddress}/balances_v2/
      operations:
      - { name: getTokenBalancesX402, method: GET, description: 'Get Token Balances For Address (X402).', outputRawFormat: json }
    - name: transactions
      path: /v1/x402/{chainName}/address/{walletAddress}/transactions_v3/
      operations:
      - { name: getRecentTransactionsX402, method: GET, description: 'Get Recent Transactions For Address (X402).', outputRawFormat: json }
    authentication:
      type: apikey
      key: Authorization
      value: 'Bearer {{env.GOLDRUSH_API_KEY}}'
      placement: header
  exposes:
  - type: mcp
    namespace: x402-endpoints-mcp
    port: 9090
    transport: http
    description: MCP adapter exposing x402 discovery and pay-per-request data tools.
    tools:
    - { name: goldrush-x402-list, description: 'List GoldRush x402 endpoints.', hints: { readOnly: true, idempotent: true }, call: x402-endpoints.listEndpoints }
    - { name: goldrush-x402-search, description: 'Search GoldRush x402 endpoints.', hints: { readOnly: true, idempotent: true }, call: x402-endpoints.searchEndpoints }
    - { name: goldrush-x402-endpoint, description: 'Get details for an x402 endpoint.', hints: { readOnly: true, idempotent: true }, call: x402-endpoints.getEndpoint }
    - { name: goldrush-x402-balances, description: 'x402-paid token balances lookup.', hints: { readOnly: true, idempotent: true }, call: x402-endpoints.getTokenBalancesX402 }
    - { name: goldrush-x402-transactions, description: 'x402-paid recent transactions lookup.', hints: { readOnly: true, idempotent: true }, call: x402-endpoints.getRecentTransactionsX402 }