Oracle Facts
by Urban Game Theory in Other
Return the latest or a subject-selected recipe-bound, source-hashed proposal lifecycle fact.
https://api.urbangametheory.xyz/agent/oracle/facts- Price
- $0.01
- per call in USDC
- Uptime
- 0.0%
- last 30 days
- Response time
- -
- no timed checks yet
- Last check
- Failed
- 5 h ago, next any minute now
Reliability
Latest check failed 5 h ago: Expected HTTP 402, got 404
Status and outage history · Atom feed · Watch with other listings
How to call it
GET https://api.urbangametheory.xyz/agent/oracle/facts
Each call costs $0.01 in USDC on Solana Devnet, paid with the request over x402.
Run a free test callOne unpaid request, the way an agent sends it. You see the payment challenge it gets back. Nothing is charged.
Example request
From the listing.
GET https://api.urbangametheory.xyz/agent/oracle/facts?market=GDYnzduynKhKgxDhvvKVarn2s23DtzA26s6hycuUYDRB&subject=Gsvt6nMhsvfrEDgvcqZDzPKZhhqACFEi3mueMxQNQ6UTParameters
| Parameter | Type | Required | Description |
|---|---|---|---|
market | string | No | Optional market account to bind into the returned recipe. |
subject | string | No | Optional Solana ProposalNFT account to verify; omit for the latest verified fact. |
Example response
The provider's example. We can't check it without paying.
{
"fact": {
"eventType": "proposal_lifecycle",
"observedAt": "2026-09-21T16:24:07.000Z",
"outcome": "cancelled",
"subject": {
"id": "Gsvt6nMhsvfrEDgvcqZDzPKZhhqACFEi3mueMxQNQ6UT",
"type": "proposal"
}
},
"recipe": {
"hash": "sha256:0000000000000000000000000000000000000000000000000000000000000000",
"id": "proposal-lifecycle-v1"
},
"verification": {
"checks": {
"subjectMatches": true
},
"status": "verified"
}
}Call it from code
The curl command shows the payment challenge. The JavaScript and Python versions pay and call, and never pay more than $0.01.
curl: see the payment challenge
# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i 'https://api.urbangametheory.xyz/agent/oracle/facts?market=GDYnzduynKhKgxDhvvKVarn2s23DtzA26s6hycuUYDRB&subject=Gsvt6nMhsvfrEDgvcqZDzPKZhhqACFEi3mueMxQNQ6UT'
# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - 'https://api.urbangametheory.xyz/agent/oracle/facts?market=GDYnzduynKhKgxDhvvKVarn2s23DtzA26s6hycuUYDRB&subject=Gsvt6nMhsvfrEDgvcqZDzPKZhhqACFEi3mueMxQNQ6UT' \
| grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decodeJavaScript: pay and call
// npm i @x402/fetch @x402/svm @solana/kit @scure/base
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactSvmScheme } from "@x402/svm/exact/client";
import { createKeyPairSignerFromBytes } from "@solana/kit";
import { base58 } from "@scure/base";
// Pays at most $0.01 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.01" });
registerExactSvmScheme(client, { signer: await createKeyPairSignerFromBytes(base58.decode(process.env.SVM_PRIVATE_KEY)) });
const pay = wrapFetchWithPayment(fetch, client);
// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.01 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fapi.urbangametheory.xyz%2Fagent%2Foracle%2Ffacts
const res = await pay("https://api.urbangametheory.xyz/agent/oracle/facts?market=GDYnzduynKhKgxDhvvKVarn2s23DtzA26s6hycuUYDRB&subject=Gsvt6nMhsvfrEDgvcqZDzPKZhhqACFEi3mueMxQNQ6UT");
console.log(res.status, await res.text());Python: pay and call
# pip install "x402[requests,svm]"
import os
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.svm import KeypairSigner
from x402.mechanisms.svm.exact.register import register_exact_svm_client
# Pays at most $0.01 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.01"})
register_exact_svm_client(client, KeypairSigner.from_base58(os.environ["SVM_PRIVATE_KEY"]))
with x402_requests(client) as session:
res = session.get("https://api.urbangametheory.xyz/agent/oracle/facts?market=GDYnzduynKhKgxDhvvKVarn2s23DtzA26s6hycuUYDRB&subject=Gsvt6nMhsvfrEDgvcqZDzPKZhhqACFEi3mueMxQNQ6UT")
print(res.status_code, res.text)Security scan
No findings
We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.
Recent checks
| When | Result | HTTP | Time | Price |
|---|---|---|---|---|
| 5 h ago | Expected HTTP 402, got 404 | 404 | 201 ms | - |
| 13 h ago | Expected HTTP 402, got 404 | 404 | 325 ms | - |
| 21 h ago | Expected HTTP 402, got 404 | 404 | 207 ms | - |
| 30 h ago | Expected HTTP 402, got 404 | 404 | 216 ms | - |
| 38 h ago | Expected HTTP 402, got 404 | 404 | 252 ms | - |
Show 10 older checks
| 46 h ago | Expected HTTP 402, got 404 | 404 | 203 ms | - |
| 2 days ago | Expected HTTP 402, got 404 | 404 | 253 ms | - |
| 3 days ago | Expected HTTP 402, got 404 | 404 | 302 ms | - |
| 3 days ago | Expected HTTP 402, got 404 | 404 | 206 ms | - |
| 3 days ago | Expected HTTP 402, got 404 | 404 | 220 ms | - |
| 3 days ago | Expected HTTP 402, got 404 | 404 | 240 ms | - |
| 4 days ago | Expected HTTP 402, got 404 | 404 | 225 ms | - |
| 4 days ago | Expected HTTP 402, got 404 | 404 | 211 ms | - |
| 4 days ago | Expected HTTP 402, got 404 | 404 | 266 ms | - |
| 5 days ago | Expected HTTP 402, got 404 | 404 | 274 ms | - |