{
  "openapi": "3.1.0",
  "info": {
    "title": "AI17Z Studio public API",
    "version": "1.0.0",
    "description": "Read-only public reads of the views this site's public pages already show, as JSON. Every route is a GET that needs no account, no key and no cookie. Requests are rate limited per address: 60 requests per minute, shared by every route. A body carries paper and simulated data and no score, rank or verdict. Observation, not advice. The routes listed here are the whole list. Status codes and the cache lifetime are on the reference page."
  },
  "servers": [
    {
      "url": "https://ai17z.io"
    }
  ],
  "externalDocs": {
    "description": "The reference page, with a command for each route.",
    "url": "https://ai17z.io/developers/api"
  },
  "paths": {
    "/api/public/seasons/{slug}": {
      "get": {
        "operationId": "getSeason",
        "summary": "One paper league season and its standings, as the season page shows them.",
        "description": "The same view as the page /league/{slug}.\n\nA season stays readable after it ends. A cancelled one answers with its reason and no standings.\n\nA standings row holds an alias and what the page shows. It holds no account, wallet or entry id.",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "The season's address on /league.",
            "schema": {}
          }
        ],
        "responses": {
          "200": {
            "description": "The view as JSON. The reference names these top-level fields and no others.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "season": {},
                    "standings": {},
                    "asOf": {}
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/public/seasons/{slug}/entries/{alias}": {
      "get": {
        "operationId": "getSeasonEntry",
        "summary": "One entrant's card in a season, as its permalink page shows it.",
        "description": "The same view as the page /league/{slug}/entry/{alias}.\n\nA withdrawn entrant, an alias that is not in the standings and a season that never ran are the same 404.",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "The season's address on /league.",
            "schema": {}
          },
          {
            "name": "alias",
            "in": "path",
            "required": true,
            "description": "The entrant's alias, percent-encoded. Case and spacing are ignored, as on the page.",
            "schema": {}
          }
        ],
        "responses": {
          "200": {
            "description": "The view as JSON. The reference names these top-level fields and no others.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "season": {},
                    "entry": {},
                    "asOf": {}
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/public/track-records": {
      "get": {
        "operationId": "getRecords",
        "summary": "The directory of published paper track records, newest publication first.",
        "description": "The same view as the page /records.\n\nA row is id, alias, start, end and publishedAt. A draft and a revoked record are absent.\n\nnext is null on the last page. An after that is not a published record answers an empty list, not a 404.",
        "parameters": [
          {
            "name": "after",
            "in": "query",
            "required": false,
            "description": "The next value from the previous answer, to read the following page.",
            "schema": {}
          }
        ],
        "responses": {
          "200": {
            "description": "The view as JSON. The reference names these top-level fields and no others.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "rows": {},
                    "next": {}
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/public/track-records/{id}": {
      "get": {
        "operationId": "getRecord",
        "summary": "One published paper track record, the snapshot fixed when it was published.",
        "description": "The same view as the page /records/{id}.\n\nA draft, a revoked record and an id nobody holds are the same 404.\n\nversion is 1, 2 or 3. A version 2 filled decision may carry fill, the simulated pricing its stored paper fill recorded; a version 3 decision may carry record, the projected stored decision record. A field the decision did not record is absent, not zero.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "A record id from the directory above.",
            "schema": {}
          }
        ],
        "responses": {
          "200": {
            "description": "The view as JSON. The reference names these top-level fields and no others.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "version": {},
                    "alias": {},
                    "quote": {},
                    "start": {},
                    "end": {},
                    "cutoff": {},
                    "startingCapitalBase": {},
                    "totals": {},
                    "costs": {},
                    "openPositionTreatment": {},
                    "decisions": {}
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/public/homes/{slug}/receipts": {
      "get": {
        "operationId": "getReceipts",
        "summary": "The receipts of one public agent home, as its receipts page lists them.",
        "description": "The same view as the page /a/{slug}/receipts.\n\nA home that hides its activity answers its alias and no rows. A row the owner hid is absent.\n\nAn unpublished home, a suspended owner and an address nobody holds are the same 404.",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "The home's address on /a.",
            "schema": {}
          }
        ],
        "responses": {
          "200": {
            "description": "The view as JSON. The reference names these top-level fields and no others.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "alias": {},
                    "rows": {}
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/public/dna": {
      "get": {
        "operationId": "getDna",
        "summary": "The published Trader DNA studies, newest first.",
        "description": "The same view as the page /dna.\n\nA study is absent until an operator publishes it, and again once it is unpublished. The list names no wallet.",
        "responses": {
          "200": {
            "description": "The view as JSON. The reference names these top-level fields and no others.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "studies": {}
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/public/pulse": {
      "get": {
        "operationId": "getPulse",
        "summary": "The last completed UTC day of the community paper pulse, and its history, both anonymous.",
        "description": "The same view as the page /community/paper.\n\nWhen too few accounts opted in, pulse.status is INSUFFICIENT and carries no totals.\n\nA read that failed inside the pulse is a 200 with pulse.status UNAVAILABLE, so check it before treating an empty history as a quiet day.",
        "responses": {
          "200": {
            "description": "The view as JSON. The reference names these top-level fields and no others.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "pulse": {},
                    "history": {}
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/public/radar": {
      "get": {
        "operationId": "getRadar",
        "summary": "The latest pools the launch radar sampled, newest first, with each dated survival reading.",
        "description": "The same view as the page /radar.\n\nAn episode is mint, dex, discoveredAt, liquidityUsd, indexRead, risk, checkpoints and sixHours. It holds no price, change, candle, pool address or agent.\n\nA reading that was not taken is state not_read with a reason. It is never a guessed value, and nothing here is a rate or a rank.",
        "responses": {
          "200": {
            "description": "The view as JSON. The reference names these top-level fields and no others.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "episodes": {},
                    "asOf": {}
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/public/watch/{mint}": {
      "get": {
        "operationId": "getWatch",
        "summary": "The stored readings a risk watch reads for one Solana address, as the watch-a-coin page shows them.",
        "description": "The same view as the page /watch/{mint}.\n\nEach group holds facts. A fact is a reading with its source and either a dated value or state not_read with a reason. A reading that was not taken is never a guessed value.\n\nNone of it fired anything. These are stored readings, not alerts, and the route says nothing about an account, a watch or a wallet.",
        "parameters": [
          {
            "name": "mint",
            "in": "path",
            "required": true,
            "description": "The Solana address, exactly as it is written. Anything else is a 404.",
            "schema": {}
          }
        ],
        "responses": {
          "200": {
            "description": "The view as JSON. The reference names these top-level fields and no others.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "mint": {},
                    "asOf": {},
                    "groups": {}
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/public/check/{chain}/{address}": {
      "get": {
        "operationId": "getCheck",
        "summary": "The evidence lines the address check shows for one token address, each with its status, value or reason, source and time.",
        "description": "The same view as the page /check/{chain}/{address}.\n\nThe body is the page's own evidence. A line is key, label, definition, status, value, reason, source, sourceAt, fetchedAt and notes, and some lines also carry groups, items or ends (the ISO end times a lock or stream line states, soonest first). status is AVAILABLE, UNAVAILABLE or STALE. A figure that could not be read is UNAVAILABLE with a reason, never zero, and the same goes for a whole chain that did not answer.\n\ngap is a sentence when the whole read failed and null otherwise. noCurve and noDepth are present only when the page says the same in its own row. fetchedAt is when this site read the lines, and a repeat of an address inside five minutes returns the first read with its first time.\n\nThere is no score, rank, overall field or verdict, and no holder or funder address. Reads are shared with the check page, so the page's per-address limit of 20 requests a minute and the shared ceiling on new reads apply. A spent limit or ceiling is a 429 with retryAfterSeconds, never an empty 200.",
        "parameters": [
          {
            "name": "chain",
            "in": "path",
            "required": true,
            "description": "One of solana, ethereum, base, arbitrum, bnb or robinhood. Anything else is a 400.",
            "schema": {}
          },
          {
            "name": "address",
            "in": "path",
            "required": true,
            "description": "The token's exact address. Solana addresses keep their case and EVM addresses are read in lower case. A ticker, a link or a pool address is a 400.",
            "schema": {}
          }
        ],
        "responses": {
          "200": {
            "description": "The view as JSON. The reference names these top-level fields and no others.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "chain": {},
                    "address": {},
                    "name": {},
                    "symbol": {},
                    "fetchedAt": {},
                    "lines": {},
                    "gap": {},
                    "noCurve": {},
                    "noDepth": {}
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/public/refusals": {
      "get": {
        "operationId": "getRefusals",
        "summary": "Decisions from published paper records that ended without a trade, newest first, each with the first layer of the entry path that refused it.",
        "description": "The same view as the page /refusals.\n\nA row is recordId, alias, key, at, action, network, address, execution, layer, breakerCode, sentence and sentenceWithheld. It holds no fill, total, price or agent.\n\nlayer.state is layer, none or not_recorded. A refusing layer that was not stored is not_recorded, never a guess. truncated is true when older decisions were left out; it is never a count.",
        "responses": {
          "200": {
            "description": "The view as JSON. The reference names these top-level fields and no others.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "rows": {},
                    "truncated": {}
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/public/graduations": {
      "get": {
        "operationId": "getGraduations",
        "summary": "Pools that moved off their launchpad's curve in the last day, newest first, each with the holder figures the token index reported at that moment.",
        "description": "The same view as the page /graduations.\n\nA row is mint, symbol, name, graduatedAt, stale and the concentration figures devHoldsPct, topHoldersPct, largestHolderPct, bundlerPct and holderCount. It holds no price, change, market cap, liquidity or agent.\n\nA figure the index did not report is null, never zero. withheld is a flag for a graduation left out because its own record had no usable address or time; it is never a count.",
        "responses": {
          "200": {
            "description": "The view as JSON. The reference names these top-level fields and no others.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "rows": {},
                    "asOf": {},
                    "withheld": {}
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
