skavio-eu paid web data API

openapi: 3.2.0
info:
  title: Skavio x402 Base USDC Payment API and DeepSeek Web Tools…
  version: 2026-10-28-prod
  description: Inspect native Circle USDC on six EVM chains and Solana. API fees settle separately in native USDC on Base via x402 v2. No custody or wallet keys. Verify inspects transfers; Match requires exactly one finalized recipient/amount match; PDF is evidence, not a tax invoice. Production DeepSeek web routes are live, with funded Web Fetch settlement separately verified on 28 October 2026.
servers:
- url: https://getskavio.com
tags:
- name: paid web data
paths:
  /x402/v1/web/search:
    post:
      summary: Ranked web search results with real source URLs from DeepSeek Search
      operationId: web_search_route_x402_v1_web_search_post
      responses:
        '200':
          description: Paid result. Body matches the documented output schema.
          content:
            application/json:
              schema:
                type: object
                properties:
                  tool:
                    type: string
                    const: web_search
                  provider:
                    type: string
                    const: deepseek-search
                  query:
                    type: string
                  count:
                    type: integer
                  ori_question:
                    type:
                    - string
                    - 'null'
                  no_results:
                    type: boolean
                    description: True when DeepSeek answered 200 with an empty result set.
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        rank:
                          type: integer
                          minimum: 1
                        title:
                          type: string
                        url:
                          type: string
                        snippet:
                          type: string
                        snippet_source:
                          type: string
                          enum:
                          - snippet
                          - summary
                          - content
                          - absent
                        summary:
                          type: string
                        site_name:
                          type:
                          - string
                          - 'null'
                        published:
                          type:
                          - string
                          - 'null'
                        rerank_score:
                          type:
                          - number
                          - 'null'
                          description: DeepSeek rerank score, 0..3. 1.5+ suggests relevance, not truth.
                        authority:
                          type:
                          - integer
                          - 'null'
                          description: DeepSeek authority, -1..4. 3+ suggests a strong source, not truth.
                        provenance:
                          type: object
                      required:
                      - rank
                      - title
                      - url
                  sources:
                    type: array
                    items:
                      type: string
                  billing:
                    type: object
                  limitations:
                    type: array
                    items:
                      type: string
                  disclosure:
                    type: object
                  cost:
                    type: object
                    properties:
                      provider_calls:
                        type: integer
                      search_calls:
                        type: integer
                      fetch_calls:
                        type: integer
                      flash_input_tokens:
                        type: integer
                      flash_output_tokens:
                        type: integer
                      provider_cost_usd:
                        type: number
                    required:
                    - provider_calls
                    - provider_cost_usd
                  latency_ms:
                    type: integer
                required:
                - tool
                - provider
                - query
                - count
                - results
                - sources
                - cost
              example:
                tool: web_search
                provider: deepseek-search
                query: x402 payment protocol Base USDC
                ori_question: null
                no_results: false
                count: 2
                results:
                - rank: 1
                  title: x402
                  url: https://example.com/x402
                  snippet: x402 is an HTTP payment protocol.
                  snippet_source: snippet
                  summary: ''
                  site_name: example.com
                  published: null
                  rerank_score: 2.4
                  authority: 3
                  provenance:
                    provider: deepseek-search
                    field_origin: upstream
                - rank: 2
                  title: USDC on Base
                  url: https://example.com/usdc-base
                  snippet: Native USDC contract on Base.
                  snippet_source: snippet
                  summary: ''
                  site_name: example.com
                  published: null
                  rerank_score: 1.9
                  authority: 2
                  provenance:
                    provider: deepseek-search
                    field_origin: upstream
                sources:
                - https://example.com/x402
                - https://example.com/usdc-base
                billing:
                  delivery_billed: true
                  provider_charged: true
                  note: DeepSeek bills a non-empty Search 200.
                limitations:
                - Results come from DeepSeek Search; Skavio does not fabricate or complete missing results.
                disclosure:
                  ai_generated: false
                  provider: deepseek
                  fallback: none
                cost:
                  provider_calls: 1
                  search_calls: 1
                  fetch_calls: 0
                  flash_input_tokens: 0
                  flash_output_tokens: 0
                  provider_cost_usd: 0.00075
                  scope: deepseek invoice expense, not customer revenue
                latency_ms: 240
        '402':
          description: Payment required or settlement rejected. No delivery on an unpaid call.
          headers:
            PAYMENT-REQUIRED:
              description: Base64 x402 v2 PaymentRequired including Bazaar discovery.
              schema:
                type: string
        '403':
          description: Target address or port blocked by the SSRF policy.
        '409':
          description: Replay of an already settled payment nonce.
        '413':
          description: Request body above the hard size cap.
        '422':
          description: Invalid request document. This never settles, so it is not charged.
        '502':
          description: Upstream DeepSeek retrieval failed. Never settled.
        '503':
          description: DeepSeek provider unavailable or rate limited. Never settled.
        '504':
          description: Provider timeout. Never settled.
      description: 'Ranked web search results with real source URLs from DeepSeek Search. No synthesis, no fabricated hits. Production HTTP 402 challenge quotes the current Base USDC price per request; inspect it before signing. Send a JSON body matching the request schema. First response is HTTP 402 with PAYMENT-REQUIRED; retry with PAYMENT-SIGNATURE. Provider: deepseek-search.'
      tags:
      - paid web data
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  minLength: 1
                  maxLength: 128
                  description: Search query, 1 to 128 Unicode characters. Sent to DeepSeek Search unchanged after control-character stripping.
                count:
                  type: integer
                  minimum: 1
                  maximum: 10
                  default: 5
                  description: Requested result count. The service caps at 10 even though the provider allows 50.
                include_content:
                  type: boolean
                  default: false
                  description: Ask DeepSeek for page content inside the search results (need_content). Bounded by the service; adds no Skavio-side model call.
                ori_question:
                  type: string
                  minLength: 1
                  maxLength: 128
                  description: Optional original user question passed to DeepSeek as ori_question to improve query understanding. Bounded to 128 characters.
              required:
              - query
              additionalProperties: false
            example:
              query: x402 payment protocol Base USDC
              count: 5
              include_content: false
      x-payment-info:
        protocol: x402
        version: 2
        network: eip155:8453
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        asset_name: native Circle USDC on Base
        amount: '20000'
        price_usdc: '0.02'
        provider: deepseek-search
        staging_price_proposal: true
  /x402/v1/web/fetch:
    post:
      summary: Bounded retrieval of one public page as Markdown or text with byte counters and…
      operationId: web_fetch_route_x402_v1_web_fetch_post
      responses:
        '200':
          description: Paid result. Body matches the documented output schema.
          content:
            application/json:
              schema:
                type: object
                properties:
                  tool:
                    type: string
                    const: web_fetch
                  provider:
                    type: string
                  requested_url:
                    type: string
                  url:
                    type: string
                  title:
                    type: string
                  output_format:
                    type: string
                    enum:
                    - markdown
                    - text
                  content_type:
                    type: string
                  content:
                    type: string
                  text:
                    type: string
                  headings:
                    type: array
                    items:
                      type: object
                  word_count:
                    type: integer
                  char_count:
                    type: integer
                  truncated:
                    type: boolean
                  citations:
                    type: array
                    items:
                      type: string
                  limitations:
                    type: array
                    items:
                      type: string
                  disclosure:
                    type: object
                  cost:
                    type: object
                    properties:
                      provider_calls:
                        type: integer
                      search_calls:
                        type: integer
                      fetch_calls:
                        type: integer
                      flash_input_tokens:
                        type: integer
                      flash_output_tokens:
                        type: integer
                      provider_cost_usd:
                        type: number
                    required:
                    - provider_calls
                    - provider_cost_usd
                  latency_ms:
                    type: integer
                required:
                - tool
                - provider
                - url
                - content
                - truncated
                - cost
              example:
                tool: web_fetch
                provider: deepseek-fetch
                requested_url: https://example.com/article
                url: https://example.com/article
                title: Example article
                output_format: markdown
                content_type: text/markdown
                content: '# Example article


                  Body text.'
                text: '# Example article


                  Body text.'
                headings:
                - level: 1
                  text: Example article
                word_count: 4
                char_count: 30
                truncated: false
                citations: []
                limitations:
                - Retrieved via DeepSeek Fetch, which returns Markdown; raw HTML is not returned.
                disclosure:
                  ai_generated: false
                  provider: deepseek
                  fallback: none
                cost:
                  provider_calls: 1
                  search_calls: 0
                  fetch_calls: 1
                  flash_input_tokens: 0
                  flash_output_tokens: 0
                  provider_cost_usd: 0.00075
                latency_ms: 310
        '402':
          description: Payment required or settlement rejected. No delivery on an unpaid call.
          headers:
            PAYMENT-REQUIRED:
              description: Base64 x402 v2 PaymentRequired including Bazaar discovery.
              schema:
                type: string
        '403':
          description: Target address or port blocked by the SSRF policy.
        '409':
          description: Replay of an already settled payment nonce.
        '413':
          description: Request body above the hard size cap.
        '422':
          description: Invalid request document. This never settles, so it is not charged.
        '502':
          description: Upstream DeepSeek retrieval failed. Never settled.
        '503':
          description: DeepSeek provider unavailable or rate limited. Never settled.
        '504':
          description: Provider timeout. Never settled.
      description: 'Bounded retrieval of one public page as Markdown or text with byte counters and truncation flags. Raw HTML is never returned. Production HTTP 402 challenge quotes the current Base USDC price per request; inspect it before signing. Send a JSON body matching the request schema. First response is HTTP 402 with PAYMENT-REQUIRED; retry with PAYMENT-SIGNATURE. Provider: deepseek-fetch.'
      tags:
      - paid web data
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                url:
                  type: string
                  minLength: 12
                  maxLength: 2048
                  format: uri
                  pattern: ^https?://[^\s@]+$
                  description: Absolute public http(s) URL. Private, loopback, link-local and metadata addresses are rejected before retrieval.
                max_bytes:
                  type: integer
                  minimum: 1024
                  maximum: 2097152
                  default: 2097152
                  description: Hard cap on retrieved body bytes. Values above the service cap are rejected, not silently reduced.
                output_format:
                  type: string
                  enum:
                  - markdown
                  - text
                  default: markdown
                  description: Delivery format. Raw HTML is never returned.
              required:
              - url
              additionalProperties: false
            example:
              url: https://example.com/article
              output_format: markdown
      x-payment-info:
        protocol: x402
        version: 2
        network: eip155:8453
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        asset_name: native Circle USDC on Base
        amount: '10000'
        price_usdc: '0.01'
        provider: deepseek-fetch
        staging_price_proposal: true
  /x402/v1/web/extract:
    post:
      summary: 'Deterministic structured extraction of one public page: title, headings…'
      operationId: web_extract_route_x402_v1_web_extract_post
      responses:
        '200':
          description: Paid result. Body matches the documented output schema.
          content:
            application/json:
              schema:
                type: object
                properties:
                  tool:
                    type: string
                    const: web_extract
                  provider:
                    type: string
                  requested_url:
                    type: string
                  url:
                    type: string
                  title:
                    type: string
                  content_type:
                    type: string
                  blocks:
                    type: array
                    items:
                      type: object
                  headings:
                    type: array
                    items:
                      type: object
                  metadata:
                    type: object
                  canonical_url:
                    type:
                    - string
                    - 'null'
                  language:
                    type:
                    - string
                    - 'null'
                  text:
                    type: string
                  word_count:
                    type: integer
                  bytes_read:
                    type: integer
                  truncated:
                    type: boolean
                  evidence:
                    type: object
                  analysis:
                    type:
                    - object
                    - 'null'
                  limitations:
                    type: array
                    items:
                      type: string
                  disclosure:
                    type: object
                  cost:
                    type: object
                    properties:
                      provider_calls:
                        type: integer
                      search_calls:
                        type: integer
                      fetch_calls:
                        type: integer
                      flash_input_tokens:
                        type: integer
                      flash_output_tokens:
                        type: integer
                      provider_cost_usd:
                        type: number
                    required:
                    - provider_calls
                    - provider_cost_usd
                  latency_ms:
                    type: integer
                required:
                - tool
                - provider
                - url
                - title
                - text
                - truncated
                - evidence
                - cost
              example:
                tool: web_extract
                provider: deepseek-fetch
                requested_url: https://example.com/article
                url: https://example.com/article
                title: Example article
                content_type: text/markdown
                blocks:
                - type: h1
                  text: Example article
                - type: p
                  text: Body text.
                headings:
                - level: 1
                  text: Example article
                metadata: {}
                canonical_url: null
                language: en
                text: '# Example article


                  Body text.'
                word_count: 4
                bytes_read: 30
                truncated: false
                evidence:
                  source_url: https://example.com/article
                  retrieved_at: '2026-10-27T00:00:00Z'
                  extraction: deterministic-markdown
                analysis: null
                limitations:
                - Deterministic extraction only; no facts are inferred beyond the retrieved document.
                disclosure:
                  ai_generated: false
                  provider: deepseek
                  fallback: none
                cost:
                  provider_calls: 1
                  search_calls: 0
                  fetch_calls: 1
                  flash_input_tokens: 0
                  flash_output_tokens: 0
                  provider_cost_usd: 0.00075
                latency_ms: 340
        '402':
          description: Payment required or settlement rejected. No delivery on an unpaid call.
          headers:
            PAYMENT-REQUIRED:
              description: Base64 x402 v2 PaymentRequired including Bazaar discovery.
              schema:
                type: string
        '403':
          description: Target address or port blocked by the SSRF policy.
        '409':
          description: Replay of an already settled payment nonce.
        '413':
          description: Request body above the hard size cap.
        '422':
          description: Invalid request document. This never settles, so it is not charged.
        '502':
          description: Upstream DeepSeek retrieval failed. Never settled.
        '503':
          description: DeepSeek provider unavailable or rate limited. Never settled.
        '504':
          description: Provider timeout. Never settled.
      description: 'Deterministic structured extraction of one public page: title, headings, readable blocks, metadata and source evidence. No model inference. Production HTTP 402 challenge quotes the current Base USDC price per request; inspect it before signing. Send a JSON body matching the request schema. First response is HTTP 402 with PAYMENT-REQUIRED; retry with PAYMENT-SIGNATURE. Provider: deepseek-fetch.'
      tags:
      - paid web data
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                url:
                  type: string
                  minLength: 12
                  maxLength: 2048
                  format: uri
                  pattern: ^https?://[^\s@]+$
                  description: Absolute public http(s) URL. Private, loopback, link-local and metadata addresses are rejected before retrieval.
                max_bytes:
                  type: integer
                  minimum: 1024
                  maximum: 2097152
                  default: 2097152
                  description: Hard cap on retrieved body bytes. Values above the service cap are rejected, not silently reduced.
              required:
              - url
              additionalProperties: false
            example:
              url: https://example.com/article
      x-payment-info:
        protocol: x402
        version: 2
        network: eip155:8453
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        asset_name: native Circle USDC on Base
        amount: '20000'
        price_usdc: '0.02'
        provider: deepseek-fetch
        staging_price_proposal: true
  /x402/v1/web/extract/analyze:
    post:
      summary: Deterministic extraction plus bounded DeepSeek Flash JSON analysis with source…
      operationId: web_extract_analyze_route_x402_v1_web_extract_analyze_post
      responses:
        '200':
          description: Paid result. Body matches the documented output schema.
          content:
            application/json:
              schema:
                type: object
                properties:
                  tool:
                    type: string
                    const: web_extract
                  provider:
                    type: string
                  requested_url:
                    type: string
                  url:
                    type: string
                  title:
                    type: string
                  content_type:
                    type: string
                  blocks:
                    type: array
                    items:
                      type: object
                  headings:
                    type: array
                    items:
                      type: object
                  metadata:
                    type: object
                  canonical_url:
                    type:
                    - string
                    - 'null'
                  language:
                    type:
                    - string
                    - 'null'
                  text:
                    type: string
                  word_count:
                    type: integer
                  bytes_read:
                    type: integer
                  truncated:
                    type: boolean
                  evidence:
                    type: object
                  analysis:
                    type:
                    - object
                    - 'null'
                    properties:
                      model:
                        type: string
                        const: deepseek-flash
                      source_url:
                        type: string
                      structured:
                        type:
                        - object
                        - 'null'
                      raw:
                        type:
                        - string
                        - 'null'
                      tokens:
                        type: object
                      cost_usd:
                        type: number
                      trust:
                        type: string
                  limitations:
                    type: array
                    items:
                      type: string
                  disclosure:
                    type: object
                  cost:
                    type: object
                    properties:
                      provider_calls:
                        type: integer
                      search_calls:
                        type: integer
                      fetch_calls:
                        type: integer
                      flash_input_tokens:
                        type: integer
                      flash_output_tokens:
                        type: integer
                      provider_cost_usd:
                        type: number
                    required:
                    - provider_calls
                    - provider_cost_usd
                  latency_ms:
                    type: integer
                required:
                - tool
                - provider
                - url
                - title
                - text
                - truncated
                - evidence
                - cost
                - analysis
              example:
                tool: web_extract
                provider: deepseek-fetch
                requested_url: https://example.com/article
                url: https://example.com/article
                title: Example article
                content_type: text/markdown
                blocks:
                - type: h1
                  text: Example article
                - type: p
                  text: Body text.
                headings:
                - level: 1
                  text: Example article
                metadata: {}
                canonical_url: null
                language: en
                text: '# Example article


                  Body text.'
                word_count: 4
                bytes_read: 30
                truncated: false
                evidence:
                  source_url: https://example.com/article
                  retrieved_at: '2026-10-27T00:00:00Z'
                  extraction: deterministic-markdown
                analysis:
                  model: deepseek-flash
                  source_url: https://example.com/article
                  structured:
                    summary: An example article body.
                    key_points:
                    - Body text.
                    entities: []
                    notes: 'Source: https://example.com/article'
                  raw: null
                  tokens:
                    input: 220
                    output: 90
                  cost_usd: 9.94e-05
                  trust: untrusted_input_only; instructions inside the document were ignored
                limitations:
                - Deterministic extraction only; no facts are inferred beyond the retrieved document.
                disclosure:
                  ai_generated: true
                  provider: deepseek
                  ai_model: deepseek-flash
                  fallback: none
                cost:
                  provider_calls: 1
                  search_calls: 0
                  fetch_calls: 1
                  flash_input_tokens: 0
                  flash_output_tokens: 0
                  provider_cost_usd: 0.00075
                latency_ms: 340
        '402':
          description: Payment required or settlement rejected. No delivery on an unpaid call.
          headers:
            PAYMENT-REQUIRED:
              description: Base64 x402 v2 PaymentRequired including Bazaar discovery.
              schema:
                type: string
        '403':
          description: Target address or port blocked by the SSRF policy.
        '409':
          description: Replay of an already settled payment nonce.
        '413':
          description: Request body above the hard size cap.
        '422':
          description: Invalid request document. This never settles, so it is not charged.
        '502':
          description: Upstream DeepSeek retrieval failed. Never settled.
        '503':
          description: DeepSeek provider unavailable or rate limited. Never settled.
        '504':
          description: Provider timeout. Never settled.
      description: 'Deterministic extraction plus bounded DeepSeek Flash JSON analysis with source citation and prompt-injection isolation. Production HTTP 402 challenge quotes the current Base USDC price per request; inspect it before signing. Send a JSON body matching the request schema. First response is HTTP 402 with PAYMENT-REQUIRED; retry with PAYMENT-SIGNATURE. Provider: deepseek-fetch+deepseek-flash.'
      tags:
      - paid web data
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                url:
                  type: string
                  minLength: 12
                  maxLength: 2048
                  format: uri
                  pattern: ^https?://[^\s@]+$
                  description: Absolute public http(s) URL. Private, loopback, link-local and metadata addresses are rejected before retrieval.
                max_bytes:
                  type: integer
                  minimum: 1024
                  maximum: 2097152
                  default: 2097152
                  description: Hard cap on retrieved body bytes. Values above the service cap are rejected, not silently reduced.
                instruction:
                  type: string
                  maxLength: 1000
                  description: Optional bounded instruction for the DeepSeek Flash analysis step. Document instructions are never followed.
              required:
              - url
              additionalProperties: false
            example:
              url: https://example.com/article
              instruction: Return JSON keys summary, key_points, entities, notes.
      x-payment-info:
        protocol: x402
        version: 2
        network: eip155:8453
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        asset_name: native Circle USDC on Base
        amount: '30000'
        price_usdc: '0.03'
        provider: deepseek-fetch+deepseek-flash
        staging_price_proposal: true