{"openapi":"3.1.0","info":{"title":"FACTA","version":"1","summary":"The public record of ERC-8004 agents and issuer-listed tokens on Robinhood Chain (chain ID 4663).","description":"Every answer reports what was observed and against which threshold, with the reads behind each figure. Observed facts and stated thresholds. Not investment advice. The free limits, keys and the envelope are on the developers page."},"servers":[{"url":"https://factahq.xyz/v1"}],"externalDocs":{"description":"The developers page","url":"https://factahq.xyz/developers"},"security":[{},{"key":[]}],"paths":{"/check/agent/{agentId}":{"get":{"operationId":"checkAgent","summary":"Who are you dealing with: the file of one ERC-8004 identity.","parameters":[{"name":"agentId","in":"path","required":true,"description":"The identity's ID.","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,9})$","example":"437"}}],"responses":{"200":{"description":"The agent envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"$ref":"#/components/responses/InvalidInput"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/check/market/{address}":{"get":{"operationId":"checkMarket","summary":"What are you trading: what an address is, and for a listed token its instrument, multiplier, feed, market state and pools.","parameters":[{"name":"address","in":"path","required":true,"description":"Any address.","schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","example":"0x5fc5360d0400a0fd4f2af552add042de9de15ffb"}}],"responses":{"200":{"description":"The market envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"$ref":"#/components/responses/InvalidInput"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/check/address/{address}":{"get":{"operationId":"checkAddress","summary":"Who is behind an address: the identities it owns or is the agent wallet of, for a caller that holds an address and not an agent ID.","parameters":[{"name":"address","in":"path","required":true,"description":"Any address: a payment's recipient, a counterparty, a sender.","schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","example":"0x5fc5360d0400a0fd4f2af552add042de9de15ffb"}}],"responses":{"200":{"description":"The address envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"$ref":"#/components/responses/InvalidInput"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/check/fill/{tx}":{"get":{"operationId":"checkFill","summary":"How well a transaction was executed: each swap's cost against its pool and its reference price.","parameters":[{"name":"tx","in":"path","required":true,"description":"A transaction hash on chain 4663.","schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"The fill envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"$ref":"#/components/responses/InvalidInput"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/check/fill/wallet/{address}":{"get":{"operationId":"checkFillWallet","summary":"A wallet's Fill report: its last swaps, measured.","parameters":[{"name":"address","in":"path","required":true,"description":"The wallet that sent the swaps.","schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","example":"0x5fc5360d0400a0fd4f2af552add042de9de15ffb"}}],"responses":{"200":{"description":"The wallet's Fill report.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"$ref":"#/components/responses/InvalidInput"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/check/fund/{vault}":{"get":{"operationId":"checkFund","summary":"A vault's factsheet, where a filed agent links it.","parameters":[{"name":"vault","in":"path","required":true,"description":"The vault's address.","schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","example":"0x5fc5360d0400a0fd4f2af552add042de9de15ffb"}}],"responses":{"200":{"description":"The factsheet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"$ref":"#/components/responses/InvalidInput"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/charter/agents/{agentId}":{"get":{"operationId":"charterOfAgent","summary":"An agent's charter status, with what each rule found.","parameters":[{"name":"agentId","in":"path","required":true,"description":"The identity's ID.","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,9})$","example":"437"}}],"responses":{"200":{"description":"The charter answer.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"$ref":"#/components/responses/InvalidInput"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/charter/roll":{"get":{"operationId":"charterRoll","summary":"The roll: every agent whose status is not Unchartered.","parameters":[{"name":"limit","in":"query","required":false,"description":"How many items, from 1 to 50.","schema":{"type":"integer","minimum":1,"maximum":50}},{"name":"cursor","in":"query","required":false,"description":"The nextCursor of the previous page, sent back unchanged.","schema":{"type":"string","maxLength":200}}],"responses":{"200":{"description":"A page of the roll.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"$ref":"#/components/responses/InvalidInput"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/charter/registries":{"get":{"operationId":"charterRegistries","summary":"The registries the attester writes to, as read each day.","parameters":[],"responses":{"200":{"description":"The registries.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/InvalidInput"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/breach/agents/{agentId}":{"get":{"operationId":"breachOfAgent","summary":"An agent's Breach mark and its newest round.","parameters":[{"name":"agentId","in":"path","required":true,"description":"The identity's ID.","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,9})$","example":"437"}}],"responses":{"200":{"description":"The Breach answer.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/InvalidInput"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/breach/rounds/{hash}":{"get":{"operationId":"breachRound","summary":"One Breach round, by the hash of its terms.","parameters":[{"name":"hash","in":"path","required":true,"description":"The round's hash.","schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"The round.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/InvalidInput"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/reports/{hash}":{"get":{"operationId":"reportByHash","summary":"A published document, byte for byte: its SHA-256 is the hash in the path.","parameters":[{"name":"hash","in":"path","required":true,"description":"The document's SHA-256.","schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"The document as stored.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/InvalidInput"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/anchors/{day}":{"get":{"operationId":"anchorOfDay","summary":"A day's anchor: the Merkle root of the SHA-256 of every document stored that UTC day, their hashes in root order, and the transaction that carries the root on chain.","parameters":[{"name":"day","in":"path","required":true,"description":"The UTC day, YYYY-MM-DD.","schema":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}$","example":"2026-11-20"}}],"responses":{"200":{"description":"The anchor.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/InvalidInput"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/anchors/hash/{hash}":{"get":{"operationId":"anchorOfDocument","summary":"A document's place in its day's anchor: the steps from its SHA-256 to the root the transaction carries.","parameters":[{"name":"hash","in":"path","required":true,"description":"The document's SHA-256.","schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"The proof.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/InvalidInput"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/notices":{"get":{"operationId":"listNotices","summary":"Material events, newest first, each one sentence from a fixed template, with its reads.","parameters":[{"name":"limit","in":"query","required":false,"description":"How many items, from 1 to 50.","schema":{"type":"integer","minimum":1,"maximum":50}},{"name":"cursor","in":"query","required":false,"description":"The nextCursor of the previous page, sent back unchanged.","schema":{"type":"string","maxLength":200}},{"name":"subject","in":"query","required":false,"description":"One subject: agent:<ID>, token:<address>, instrument:<key>, pool:v3:<address> or pool:v4:<pool ID>.","schema":{"type":"string","example":"agent:437"}}],"responses":{"200":{"description":"A page of notices.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"400":{"$ref":"#/components/responses/InvalidInput"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/notices.rss":{"get":{"operationId":"noticesRss","summary":"The newest notices as RSS 2.0, of every subject or of one.","parameters":[{"name":"subject","in":"query","required":false,"description":"One subject: agent:<ID>, token:<address>, instrument:<key>, pool:v3:<address> or pool:v4:<pool ID>.","schema":{"type":"string","example":"agent:437"}}],"responses":{"200":{"description":"RSS 2.0.","content":{"application/rss+xml":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/InvalidInput"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/stats":{"get":{"operationId":"stats","summary":"The counts the jobs stored, with when each was stored.","parameters":[],"responses":{"200":{"description":"The counts, or null before the first are stored.","content":{"application/json":{"schema":{"type":"object","properties":{"stats":{"type":["object","null"]}}}}}},"400":{"$ref":"#/components/responses/InvalidInput"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/publisher":{"get":{"operationId":"publisher","summary":"The addresses the publisher of FACTA controls, labelled on every page they appear on.","parameters":[],"responses":{"200":{"description":"The publisher's addresses.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/InvalidInput"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}}},"components":{"securitySchemes":{"key":{"type":"http","scheme":"bearer","description":"Optional: a key from the account page, ck_<id>_<secret>, for the limits of a key. Every read call answers without one."}},"schemas":{"Envelope":{"type":"object","description":"The envelope every surface returns, built by one code path: the record, its terms, every figure with its evidence, the notices, the documents, the method versions and the disclaimer. Its fields are on the developers page.","required":["record"],"properties":{"record":{"type":"object"},"terms":{"type":"object"},"figures":{"type":"array","items":{"type":"object"}},"notices":{"type":"array","items":{"type":"object"}}}},"Page":{"type":"object","required":["items","nextCursor"],"properties":{"items":{"type":"array","items":{"type":"object"}},"nextCursor":{"type":["string","null"]}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","next"],"properties":{"code":{"type":"string","enum":["invalid_input","unauthorized","forbidden","not_found","rate_limited","unavailable"]},"message":{"type":"string","description":"What happened, in one sentence."},"next":{"type":"string","description":"What to do next."},"retryAfterSeconds":{"type":"integer"}}}}}},"responses":{"InvalidInput":{"description":"The input is not in the expected form; the message says which form is.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Nothing is on file for this subject, or the call is not open where its switch is off.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"A limit refused the call; the answer names it and when to try again.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unavailable":{"description":"A source did not answer in time; nothing was guessed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}