> ## Documentation Index > Fetch the complete documentation index at: https://docs.routeur.app/llms.txt > Use this file to discover all available pages before exploring further. # Unusual flow > Markets whose last 15 minutes of trading were unusual against their own previous week, scored every five minutes. Repeated detections of the same market and kind within an hour extend one signal. Signals describe trading, not its cause. ## OpenAPI ````yaml /openapi.yaml get /v1/flow openapi: 3.1.0 info: title: Routeur Graph API version: '2026-09-15' summary: >- Proven relations between Kalshi and Polymarket contracts, with the history and signals built on them. description: > Routeur reads every open market on Kalshi and global Polymarket, and proves which ones imply, exclude or equal each other from each venue's structured contract terms and exact arithmetic. No relation is inferred from prose, and ambiguous or conflicting evidence is withheld. ## Authentication Send your key in the `X-API-Key` header, or as `Authorization: Bearer `. Keys look like `rk_live_<12-character id>_<43-character secret>` and are shown once when issued. Keep them server-side. ## Rate limits Every key has a per-minute limit and a per-day quota set by its tier: | Tier | Requests per minute | Requests per day | |---|---|---| | free | 30 | 2,000 | | trader | 120 | 50,000 | | pro | 600 | 500,000 | | institutional | 3,000 | 10,000,000 | Responses carry `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset` (Unix seconds) for the minute window, and `X-Daily-Quota-Limit` and `X-Daily-Quota-Remaining` for the day (UTC). A request over either limit returns `429` with `Retry-After` in seconds. ## Conventions - Money and prices are decimal strings in USD (for example `"0.4100"`), never floats. Prices are per contract that pays $1. - Times are RFC 3339 in UTC. - Successful responses wrap results in `data`. Graph-derived responses also name the `graph_run` they were read from; runs finish hourly. - Paginated lists return `next_cursor` when more results exist. Pass it back as `cursor` unchanged; cursors are opaque. - Unknown or repeated query parameters are rejected with `400`, so typos never silently widen a query. ## Errors Errors return a JSON body `{"error": {"code": "...", "message": "..."}}`. Branch on `code`; messages may change. | Status | Code | Meaning | |---|---|---| | 400 | `invalid_parameter` | A query parameter is unknown, repeated or out of range. | | 400 | `invalid_market` | The venue is not `kalshi` or `polymarket`, or the market id is malformed. | | 401 | `api_key_required` | No key was sent. | | 401 | `invalid_api_key` | The key is malformed or unknown. | | 401 | `api_key_revoked` | The key was revoked. | | 404 | `market_not_found` | The market is not in the latest graph. | | 404 | `not_found` | No such endpoint. | | 429 | `rate_limited` | The per-minute limit was exceeded. | | 429 | `daily_quota_exceeded` | The daily quota is used up. | | 503 | `graph_unavailable` | No graph run has finished yet. | | 504 | `timeout` | The request took longer than 15 seconds. | | 500 | `internal` | Something failed on our side. | ## Webhooks Mispricing alerts are delivered as signed `POST` requests; see the `webhooks` section. Each request carries `Routeur-Signature: t=,v1=`, where `v1` is HMAC-SHA256 of `.` keyed by your subscription's signing secret. Reject requests whose signature does not match or whose `t` is more than five minutes old, and respond `2xx` within 10 seconds. `Routeur-Delivery` identifies the delivery and stays the same across retries, so use it to ignore duplicates. Any response other than `2xx` or `410`, or no response, is retried with exponential backoff from 30 seconds for up to 8 attempts; responding `410 Gone` disables the subscription. Endpoints must be HTTPS on a public address, and redirects are not followed. contact: name: Routeur url: https://routeur.app servers: - url: https://api.routeur.app security: - apiKey: [] - bearer: [] tags: - name: Events description: Real-world events across both venues, the way people browse them. - name: Graph description: Markets and the relations proven between them. - name: History description: Recorded quotes and trades. - name: Signals description: Mispricing leads and unusual trading derived from the graph and history. - name: Service description: Service status and this document. paths: /v1/flow: get: tags: - Signals summary: Unusual flow description: > Markets whose last 15 minutes of trading were unusual against their own previous week, scored every five minutes. Repeated detections of the same market and kind within an hour extend one signal. Signals describe trading, not its cause. operationId: listFlowSignals parameters: - $ref: '#/components/parameters/VenueFilter' - name: kind in: query description: Only signals of this kind. schema: $ref: '#/components/schemas/FlowKind' - name: hours in: query description: Signals last detected within this many hours. schema: type: integer minimum: 1 maximum: 168 default: 24 - name: limit in: query description: Signals to return, most recent first. schema: type: integer minimum: 1 maximum: 200 default: 50 responses: '200': description: Signals, most recently detected first. headers: X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' X-Daily-Quota-Limit: $ref: '#/components/headers/X-Daily-Quota-Limit' X-Daily-Quota-Remaining: $ref: '#/components/headers/X-Daily-Quota-Remaining' content: application/json: schema: type: object additionalProperties: false required: - data properties: data: type: array items: $ref: '#/components/schemas/FlowSignal' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' default: $ref: '#/components/responses/Error' components: parameters: VenueFilter: name: venue in: query description: Only results on this venue. schema: $ref: '#/components/schemas/Venue' schemas: FlowKind: type: string description: > `burst`: far more trades than the market normally sees. `large_fill`: one fill much larger than its typical trade. `one_sided`: unusual flow almost all in one direction that moved the Yes price with it. enum: - burst - large_fill - one_sided FlowSignal: type: object additionalProperties: false required: - id - kind - market - window_start - window_end - first_detected_at - last_detected_at - detections - score - metrics properties: id: type: integer kind: $ref: '#/components/schemas/FlowKind' market: type: object additionalProperties: false required: - venue - id - title properties: venue: $ref: '#/components/schemas/Venue' id: $ref: '#/components/schemas/MarketID' title: type: string window_start: $ref: '#/components/schemas/Timestamp' window_end: $ref: '#/components/schemas/Timestamp' first_detected_at: $ref: '#/components/schemas/Timestamp' last_detected_at: $ref: '#/components/schemas/Timestamp' detections: type: integer minimum: 1 score: type: number description: >- For bursts and one-sided flow, -log10 of the chance of this many trades given the market's history; for large fills, the fill's multiple of the market's mean fill. metrics: type: object description: >- The measurements behind the signal, such as `trades`, `notional_usd`, `baseline_trades_per_window`, `max_fill_usd`, `imbalance`, `yes_price_start` and `yes_price_end`. additionalProperties: type: number Venue: type: string enum: - kalshi - polymarket MarketID: type: string pattern: ^[A-Za-z0-9][A-Za-z0-9_.-]{0,199}$ Timestamp: type: string format: date-time Error: type: object additionalProperties: false required: - error properties: error: type: object additionalProperties: false required: - code - message properties: code: type: string description: A stable machine-readable code. message: type: string description: A human-readable explanation. headers: X-RateLimit-Limit: description: Requests allowed per minute for this key. schema: type: integer X-RateLimit-Remaining: description: Requests left in the current minute. schema: type: integer X-RateLimit-Reset: description: Unix time when the minute window resets. schema: type: integer X-Daily-Quota-Limit: description: Requests allowed per UTC day. schema: type: integer X-Daily-Quota-Remaining: description: Requests left today. schema: type: integer responses: BadRequest: description: Invalid parameter or market. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: invalid_parameter message: 'Invalid or unsupported query parameter: limit.' Unauthorized: description: Missing, invalid or revoked API key. headers: WWW-Authenticate: schema: type: string content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: api_key_required message: Send an API key in the X-API-Key header or as a Bearer token. TooManyRequests: description: Rate limit or daily quota exceeded. headers: Retry-After: description: Seconds until the limit resets. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' Error: description: Any other error. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: apiKey: type: apiKey in: header name: X-API-Key bearer: type: http scheme: bearer description: The same API key sent as a Bearer token. ````