CoW Swap Reveal API

The Reveal API from CoW Swap — 1 operation(s) for reveal.

Operations 1

POST /reveal Reveal calldata #

Specifications

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/cow-protocol/json-schema/cow-protocol-order-creation-schema.json
📊
JSONSchema
https://artifacts.apis.io/cow-protocol/json-schema/cow-protocol-trade-schema.json
📊
JSONSchema
https://artifacts.apis.io/cow-protocol/json-schema/cow-protocol-order-quote-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/cow-protocol/json-schema/cow-protocol-simulation-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/cow-protocol/json-schema/cow-protocol-solver-competition-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/cow-protocol/json-schema/cow-protocol-order-quote-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/cow-protocol/json-schema/cow-protocol-solve-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/cow-protocol/json-schema/cow-protocol-settle-fast-path-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/cow-protocol/json-schema/cow-protocol-solve-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/cow-protocol/json-schema/cow-protocol-settle-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/cow-protocol/json-schema/cow-protocol-reveal-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/cow-protocol/json-schema/cow-protocol-quote-response-kind-schema.json
📊
JSONSchema
https://artifacts.apis.io/cow-protocol/json-schema/cow-protocol-solution-schema.json
📊
JSONSchema
https://artifacts.apis.io/cow-protocol/json-schema/cow-protocol-auction-schema.json

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/cow-protocol:cow-protocol-reveal-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

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

OpenAPI Specification

cow-protocol-reveal-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Solver Reveal API
  description: The API implemented by Solvers to be queried by Autopilot.
  version: 0.0.1
tags:
- name: Reveal
paths:
  /reveal:
    post:
      operationId: revealCalldata
      description: 'Reveal the calldata of the previously solved auction.

        This may be used by the autopilot for the shadow competition to verify the solution before requesting its execution it on chain.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RevealRequest'
      responses:
        '200':
          description: Execution accepted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RevealResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '500':
          $ref: '#/components/responses/InternalServerError'
      tags:
      - Reveal
      summary: Reveal calldata
      x-summary-source: derived
components:
  schemas:
    Calldata:
      description: hex encoded calldata with `0x` prefix.
      type: object
      properties:
        internalized:
          description: 'The calldata without any internalized interactions encoded.

            This is the calldata that can be found on chain.'
          type: string
          example: '0x1234567890'
        uninternalized:
          description: 'The calldata with all internalized interactions encoded.


            This is the calldata that should be used for simulation/verification

            purposes.'
          type: string
          example: '0x1234567890'
    RevealResponse:
      description: Response of the reveal endpoint.
      type: object
      properties:
        calldata:
          $ref: '#/components/schemas/Calldata'
    RevealRequest:
      description: Request to the `/reveal` endpoint.
      type: object
      properties:
        solutionId:
          description: Id of the solution that should be executed.
          type: integer
          example: 123
        auctionId:
          description: Auction ID in which the specified solution ID is competing.
          type: integer
          example: 123
  responses:
    InternalServerError:
      description: 'Something went wrong when handling the request.

        Body potentially contains extra information.'
      content:
        text/plain:
          schema:
            type: string
    BadRequest:
      description: 'There is something wrong with the request.

        Body potentially contains extra information.'
      content:
        text/plain:
          schema:
            type: string