Blocksize

Blocksize Snapshots API

The Snapshots API from Blocksize — 1 operation(s) for snapshots.

Documentation GitHub OpenAPI

Operations 1

POST /v1/snapshots/macro Multi Asset Macro Snapshot #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/blocksize-info/openapi/blocksize-info-snapshots-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/blocksize-info:blocksize-info-snapshots-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Blocksize Agentic Market Intelligence Snapshots API
  description: 'Institutional-grade real-time market data gateway for autonomous AI agents.

    Supports direct x402 USDC settlement, authenticated connector starter credits,

    and a public read-only remote MCP discovery surface for directory listings and

    client onboarding.


    ### Public Integration Surfaces

    - **Developer Portal**: Homepage

    - **Remote MCP URL**: Streamable HTTP

    - **MCP Manifest**: Listing metadata

    - **OpenAPI**: JSON schema

    - **Swagger UI**: Interactive docs

    - **Quickstart**: Remote MCP install guide

    - **Prompt Examples**: Example prompts

    - **Privacy Policy**: Privacy

    - **Support**: Contact and troubleshooting'
  version: 0.6.24
tags:
- name: Snapshots
paths:
  /v1/snapshots/macro:
    post:
      summary: Multi Asset Macro Snapshot
      description: 'Create a bounded multi-asset macro snapshot. Cost: 1,000 credits or $1.00 USDC.'
      operationId: multi_asset_macro_snapshot_v1_snapshots_macro_post
      requestBody:
        content:
          application/json:
            schema:
              additionalProperties: true
              type: object
              title: Payload
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Multi Asset Macro Snapshot V1 Snapshots Macro Post
        '402':
          description: Payment Required. Returns a PAYMENT-REQUIRED header with an x402 PaymentRequired challenge.
          headers:
            PAYMENT-REQUIRED:
              description: Base64 encoded x402 PaymentRequired object.
              schema:
                type: string
          content:
            application/json:
              example:
                x402Version: 2
                error: Payment Required
                message: This endpoint requires a payment of $0.002 USDC.
                price_usdc: '0.002'
                price:
                  usdc: '0.002'
                  credits: 2
                  credit_price_usdc: '0.001'
                  display: $0.002 USDC per call (2 credits)
                sample_value:
                  example_only: true
                  live_data: false
                  example_response:
                    status: ok
                    data:
                      pair: BTC-USD
                      vwap: 100.0
                      currency: USD
                    meta:
                      provider: Blocksize Capital
                      example_only: true
                client_snippet:
                  preview_curl: curl -sS 'https://mcp.blocksize.info/v1/samples/market-data?service=vwap&symbol=BTCUSD'
                  pay_python: uv run python examples/x402/buy_with_base.py --url 'https://mcp.blocksize.info/v1/vwap/BTC-USD' --max-usdc 0.002 --pay
                free_connector:
                  url: https://mcp.blocksize.info/anthropic/mcp/
                  allowance_credits: 30000
                  this_call_costs_credits: 2
                  calls_per_month_at_this_price: 15000
                accepts:
                - scheme: exact
                  network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
                  amount: '2000'
                  asset: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                  payTo: recipient-wallet
                  maxTimeoutSeconds: 30
                networks:
                - name: Solana
                  caip2: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
                - name: Base
                  caip2: eip155:8453
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '1.00'
        protocols:
        - x402: {}
      tags:
      - Snapshots
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError