47620-xyz Polygon API

openapi: 3.2.0
info:
  title: 47620 Xyz Polygon API
  version: 2.0.0
  contact:
    email: rem@roessan.cl
  x-guidance: 'Call GET /buy/:productId with no header to receive the HTTP 402 payment requirements (accepts[] with network solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp, asset=USDC SPL mint, payTo=merchant wallet, amount in atomic units). Pay on-chain: net -> payTo (merchant), platform fee -> platformWallet (both transfers verified). Then retry the SAME URL with header X-PAYMENT: base64(JSON {txSignature, buyerWallet}). On success you get 200 with the delivery payload. GET /buy lists products (free).'
  description: 'Operations tagged Polygon across 2 of this provider''s published API definitions: 47620-xyz-openapi.yml, openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://47620.xyz
tags:
- name: Polygon
paths:
  /x/polygon/health:
    get:
      operationId: polygon-health
      summary: polygon network health (chain id, block height, gas price, native USD) — decide…
      description: 'Live polygon network health: chain id, latest block number, gas price and native token POL/USD price. Cheapest call.'
      tags:
      - Polygon
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.002'
        protocols:
        - x402: {}
      parameters:
      - name: fields
        in: query
        required: false
        schema:
          type: string
        description: Optional comma-separated top-level response keys to keep. Omit for the full payload.
      responses:
        '200':
          description: Polygon data (delivered after x402 payment)
        '402':
          description: Payment Required — x402 payment requirements
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/X402Challenge'
    servers:
    - url: https://47620.xyz
  /x/polygon/block/:number:
    get:
      operationId: polygon-block
      summary: polygon block lookup (timestamp, tx count, gas used) — confirm when something…
      description: 'Header + summary for a polygon block by number (or "latest"): hash, timestamp, tx count, gas used and base fee.'
      tags:
      - Polygon
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
        protocols:
        - x402: {}
      parameters:
      - name: fields
        in: query
        required: false
        schema:
          type: string
        description: Optional comma-separated top-level response keys to keep. Omit for the full payload.
      responses:
        '200':
          description: Polygon data (delivered after x402 payment)
        '402':
          description: Payment Required — x402 payment requirements
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/X402Challenge'
    servers:
    - url: https://47620.xyz
  /x/polygon/balance/:address:
    get:
      operationId: polygon-balance
      summary: polygon native balance in wei and USD — check funds before a payment or gas…
      description: Native POL balance (and live USD value) for any polygon address.
      tags:
      - Polygon
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
        protocols:
        - x402: {}
      parameters:
      - name: fields
        in: query
        required: false
        schema:
          type: string
        description: Optional comma-separated top-level response keys to keep. Omit for the full payload.
      responses:
        '200':
          description: Polygon data (delivered after x402 payment)
        '402':
          description: Payment Required — x402 payment requirements
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/X402Challenge'
    servers:
    - url: https://47620.xyz
  /x/polygon/stables/:address:
    get:
      operationId: polygon-stables
      summary: polygon stablecoin balances (USDC/USDT) with USD value — verify a payee…
      description: USDC/USDT/DAI balances for a polygon address (one call, all canonical stablecoins).
      tags:
      - Polygon
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.010'
        protocols:
        - x402: {}
      parameters:
      - name: fields
        in: query
        required: false
        schema:
          type: string
        description: Optional comma-separated top-level response keys to keep. Omit for the full payload.
      responses:
        '200':
          description: Polygon data (delivered after x402 payment)
        '402':
          description: Payment Required — x402 payment requirements
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/X402Challenge'
    servers:
    - url: https://47620.xyz
  /x/polygon/token/:token:
    get:
      operationId: polygon-token
      summary: polygon token market data (price, supply, decimals, symbol) — value a token…
      description: Live price, liquidity, 24h volume and DEX pairs for any polygon ERC-20 token, plus on-chain name/symbol/decimals. Live, per request.
      tags:
      - Polygon
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.020'
        protocols:
        - x402: {}
      parameters:
      - name: fields
        in: query
        required: false
        schema:
          type: string
        description: Optional comma-separated top-level response keys to keep. Omit for the full payload.
      responses:
        '200':
          description: Polygon data (delivered after x402 payment)
        '402':
          description: Payment Required — x402 payment requirements
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/X402Challenge'
    servers:
    - url: https://47620.xyz
  /x/polygon/tx/:hash:
    get:
      operationId: polygon-tx
      summary: polygon transaction lookup (status, from/to, value, gas) — verify a transfer…
      description: Status (success/reverted), block, gas used/price, from/to and value for a polygon transaction hash. Live.
      tags:
      - Polygon
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.010'
        protocols:
        - x402: {}
      parameters:
      - name: fields
        in: query
        required: false
        schema:
          type: string
        description: Optional comma-separated top-level response keys to keep. Omit for the full payload.
      responses:
        '200':
          description: Polygon data (delivered after x402 payment)
        '402':
          description: Payment Required — x402 payment requirements
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/X402Challenge'
    servers:
    - url: https://47620.xyz
  /x/polygon/contract/:address:
    get:
      operationId: polygon-contract
      summary: polygon contract info (bytecode presence, name/symbol if ERC-20) — tell a…
      description: Whether a polygon address is a contract, its bytecode size, and (for ERC-20s) name/symbol/decimals.
      tags:
      - Polygon
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.010'
        protocols:
        - x402: {}
      parameters:
      - name: fields
        in: query
        required: false
        schema:
          type: string
        description: Optional comma-separated top-level response keys to keep. Omit for the full payload.
      responses:
        '200':
          description: Polygon data (delivered after x402 payment)
        '402':
          description: Payment Required — x402 payment requirements
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/X402Challenge'
    servers:
    - url: https://47620.xyz
  /x/polygon/gas:
    get:
      operationId: polygon-gas
      summary: polygon gas oracle (slow/standard/fast tiers in gwei) — pick a fee that lands…
      description: Current polygon gas price (gwei + wei) and the estimated cost of a 21k native transfer.
      tags:
      - Polygon
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
        protocols:
        - x402: {}
      parameters:
      - name: fields
        in: query
        required: false
        schema:
          type: string
        description: Optional comma-separated top-level response keys to keep. Omit for the full payload.
      responses:
        '200':
          description: Polygon data (delivered after x402 payment)
        '402':
          description: Payment Required — x402 payment requirements
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/X402Challenge'
    servers:
    - url: https://47620.xyz
  /x/polygon/trending:
    get:
      operationId: polygon-trending
      summary: polygon trending pairs by 24h volume — find where liquidity is moving right now
      description: Trending polygon DEX pairs by 24h volume (top boosted tokens on DexScreener).
      tags:
      - Polygon
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.020'
        protocols:
        - x402: {}
      parameters:
      - name: fields
        in: query
        required: false
        schema:
          type: string
        description: Optional comma-separated top-level response keys to keep. Omit for the full payload.
      responses:
        '200':
          description: Polygon data (delivered after x402 payment)
        '402':
          description: Payment Required — x402 payment requirements
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/X402Challenge'
    servers:
    - url: https://47620.xyz
  /x/polygon/risk/:address:
    get:
      operationId: polygon-risk
      summary: polygon pre-payment risk check — wallet risk score
      description: 'Before your agent sends POL/USDC to any polygon address: check whether it is safe. Returns contract-vs-wallet, native balance, USDC balance, nonce/activity, and a 0-100 risk score with reasons. Use this to avoid paying a dead or wrong address.'
      tags:
      - Polygon
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.020'
        protocols:
        - x402: {}
      parameters:
      - name: fields
        in: query
        required: false
        schema:
          type: string
        description: Optional comma-separated top-level response keys to keep. Omit for the full payload.
      responses:
        '200':
          description: Polygon data (delivered after x402 payment)
        '402':
          description: Payment Required — x402 payment requirements
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/X402Challenge'
    servers:
    - url: https://47620.xyz
  /x/polygon/should-pay/:address:
    get:
      operationId: polygon-should-pay
      summary: polygon pre-payment decision — should I pay this address
      description: 'A pay / review / do-not-pay verdict before sending funds on polygon: contract-vs-wallet, funding, USDC balance, activity and risk, phrased as a decision an agent can act on. Optional ?amount= context.'
      tags:
      - Polygon
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.020'
        protocols:
        - x402: {}
      parameters:
      - name: fields
        in: query
        required: false
        schema:
          type: string
        description: Optional comma-separated top-level response keys to keep. Omit for the full payload.
      responses:
        '200':
          description: Polygon data (delivered after x402 payment)
        '402':
          description: Payment Required — x402 payment requirements
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/X402Challenge'
    servers:
    - url: https://47620.xyz
  /x/polygon/snapshot:
    get:
      operationId: polygon-snapshot
      summary: polygon network snapshot (bundle)
      description: 'One call for the whole polygon picture: chain id, latest block, gas price, native token POL/USD price and the canonical USDC address. Replaces several separate calls.'
      tags:
      - Polygon
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.010'
        protocols:
        - x402: {}
      parameters:
      - name: fields
        in: query
        required: false
        schema:
          type: string
        description: Optional comma-separated top-level response keys to keep. Omit for the full payload.
      responses:
        '200':
          description: Polygon data (delivered after x402 payment)
        '402':
          description: Payment Required — x402 payment requirements
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/X402Challenge'
    servers:
    - url: https://47620.xyz
  /x/polygon/market-overview:
    get:
      operationId: polygon-market-overview
      summary: polygon market overview (native price, gas, latest block) — one-call chain…
      description: 'Daily dashboard for a polygon agent: native POL/USD price, gas price, latest block and the current top boosted tokens on DexScreener. One call.'
      tags:
      - Polygon
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.010'
        protocols:
        - x402: {}
      parameters:
      - name: fields
        in: query
        required: false
        schema:
          type: string
        description: Optional comma-separated top-level response keys to keep. Omit for the full payload.
      responses:
        '200':
          description: Polygon data (delivered after x402 payment)
        '402':
          description: Payment Required — x402 payment requirements
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/X402Challenge'
    servers:
    - url: https://47620.xyz
  /x/polygon/token-safety/:token:
    get:
      operationId: polygon-token-safety
      summary: polygon token safety score — rug check
      description: '0-100 safety score with reasons for a polygon ERC-20: does the address have code, name/symbol/decimals, total supply, proxy signal, DEX liquidity and volume. A pre-trade due-diligence verdict.'
      tags:
      - Polygon
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.020'
        protocols:
        - x402: {}
      parameters:
      - name: fields
        in: query
        required: false
        schema:
          type: string
        description: Optional comma-separated top-level response keys to keep. Omit for the full payload.
      responses:
        '200':
          description: Polygon data (delivered after x402 payment)
        '402':
          description: Payment Required — x402 payment requirements
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/X402Challenge'
    servers:
    - url: https://47620.xyz
  /x/polygon/token-dossier/:token:
    get:
      operationId: polygon-token-dossier
      summary: polygon token dossier — rug check + due diligence
      description: 'Everything about a polygon ERC-20 in one call: on-chain metadata (name/symbol/decimals/totalSupply), price, liquidity, 24h volume, DEX pair count and fdv/marketCap when available.'
      tags:
      - Polygon
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.020'
        protocols:
        - x402: {}
      parameters:
      - name: fields
        in: query
        required: false
        schema:
          type: string
        description: Optional comma-separated top-level response keys to keep. Omit for the full payload.
      responses:
        '200':
          description: Polygon data (delivered after x402 payment)
        '402':
          description: Payment Required — x402 payment requirements
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/X402Challenge'
    servers:
    - url: https://47620.xyz
  /x/polygon/token-report/:token:
    get:
      operationId: polygon-token-report
      summary: polygon token full report (bundle)
      description: 'Complete token due-diligence for a polygon ERC-20 in one call: metadata, safety score, liquidity, volume and an agent-readable summary. Replaces several separate lookups.'
      tags:
      - Polygon
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.020'
        protocols:
        - x402: {}
      parameters:
      - name: fields
        in: query
        required: false
        schema:
          type: string
        description: Optional comma-separated top-level response keys to keep. Omit for the full payload.
      responses:
        '200':
          description: Polygon data (delivered after x402 payment)
        '402':
          description: Payment Required — x402 payment requirements
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/X402Challenge'
    servers:
    - url: https://47620.xyz
  /x/polygon/whale-radar/:token:
    get:
      operationId: polygon-whale-radar
      summary: polygon token whale radar — top-holder concentration & rug signals
      description: Concentration / activity radar for a polygon ERC-20. ERC-20 holder lists are NOT available from a keyless RPC, so this reports DEX liquidity, 24h volume and trade counts as an activity proxy and states holdersSource honestly. Never fabricates holder numbers.
      tags:
      - Polygon
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.020'
        protocols:
        - x402: {}
      parameters:
      - name: fields
        in: query
        required: false
        schema:
          type: string
        description: Optional comma-separated top-level response keys to keep. Omit for the full payload.
      responses:
        '200':
          description: Polygon data (delivered after x402 payment)
        '402':
          description: Payment Required — x402 payment requirements
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/X402Challenge'
    servers:
    - url: https://47620.xyz
  /x/polygon/wallet-profile/:address:
    get:
      operationId: polygon-wallet-profile
      summary: polygon wallet profile (balances, tx count, first/last activity) — judge if a…
      description: 'Complete wallet snapshot in one call: native POL balance (wei + human) + USD, USDC balance, nonce/activity and whether the address is a contract.'
      tags:
      - Polygon
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.020'
        protocols:
        - x402: {}
      parameters:
      - name: fields
        in: query
        required: false
        schema:
          type: string
        description: Optional comma-separated top-level response keys to keep. Omit for the full payload.
      responses:
        '200':
          description: Polygon data (delivered after x402 payment)
        '402':
          description: Payment Required — x402 payment requirements
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/X402Challenge'
    servers:
    - url: https://47620.xyz
components:
  schemas:
    X402Challenge:
      type: object
      properties:
        x402Version:
          type: integer
        accepts:
          type: array
          items:
            type: object
          minItems: 1
        extensions:
          type: object
          properties:
            bazaar:
              type: object
              properties:
                info:
                  type: object
                schema:
                  type: object
                  properties:
                    input:
                      type: object
                      properties:
                        type:
                          type: string
                          const: http
                        method:
                          type: string
                          enum:
                          - GET
                        queryParams:
                          type: object
                          properties: {}
                          additionalProperties: false
                      required:
                      - type
                      - method
                    output:
                      type: object
                      properties:
                        example:
                          type: object
                      required:
                      - example
                  required:
                  - input
                  - output
              required:
              - info
              - schema
      required:
      - x402Version
      - accepts
  securitySchemes:
    siwx:
      type: apiKey
      in: header
      name: X-SIWX
      description: Sign-In with X wallet proof (used by registries; not required to buy).
x-refined-from:
- 47620-xyz-openapi.yml
- openapi.json