--- name: api.paysponge.com description: api.paysponge.com exposes four distinct paid API endpoints covering blockchain network discovery, Polymarket wallet position retrieval, Kalshi prediction market listings, and the onescales.com sitemap. The endpoints are read-only data fetchers with no write, trade, or streaming capabilities. host: api.paysponge.com --- # api.paysponge.com This host aggregates a small set of unrelated data-fetching endpoints behind a single paid API gateway. It serves agents that need to query Polymarket or Kalshi prediction market data, validate supported blockchain networks, or enumerate onescales.com URLs. The endpoints are independent of one another and share no common data model; the host's value is access convenience rather than a unified domain. ## When to use this host Use this host when you need a quick read-only snapshot of Kalshi market listings, Polymarket wallet holdings, supported chain identifiers, or the onescales.com sitemap. Do not use it for placing trades or orders on any platform, real-time streaming price data, on-chain position data outside of Polymarket, health or status checks on blockchain networks, or crawling any website other than onescales.com. For live order book data or trade execution on Kalshi or Polymarket, route to those platforms' native APIs directly. For arbitrary sitemap or SEO data on other domains, use a general-purpose web crawling or sitemap service. ## Capabilities ### Blockchain Network Discovery Identifies which blockchain networks are accepted by this API, returning chain IDs, canonical names, and aliases for use in downstream request validation. - **`fetch-supported-chains`** — Returns the list of supported blockchain networks and their aliases for this paid API endpoint, including chain IDs and canonical names. ### Prediction Market Data Retrieves read-only market and portfolio data from two prediction market platforms: Kalshi market listings and Polymarket wallet positions. - **`fetch-kalshi-markets`** — Returns a paginated list of Kalshi prediction market contracts, each with ticker, title, timing, status, price, and volume fields. - **`fetch-polymarket-wallet-positions`** — Returns all Polymarket positions held by a given wallet address, with pagination metadata. ### Site Inventory Returns the full indexed URL list for onescales.com, including change frequency and last-modified metadata, suitable for crawling or content discovery tasks. - **`fetch-onescales-url-list`** — Returns the full sitemap URL list for onescales.com, including up to 200 URLs with their change frequency and last-modified timestamps. ## Workflows ### Polymarket Portfolio Chain Validation *Use when an agent needs to retrieve a wallet's Polymarket positions and first confirm that the relevant chain is supported by this API.* 1. **`fetch-supported-chains`** — Retrieve the list of supported blockchain networks and verify the target chain is present before proceeding. 2. **`fetch-polymarket-wallet-positions`** — Fetch the wallet's Polymarket positions now that the chain context has been validated. ## Skill reference ### `fetch-supported-chains` **Chain Access Checker** — Returns the list of supported blockchain networks and their aliases for this paid API endpoint, including chain IDs and canonical names. *Use when:* Use when an agent needs to discover which blockchain networks are supported by this API before routing a request or validating a chain identifier against accepted values. *Not for:* Do not use for real-time chain status or health checks; this endpoint only lists supported chains, not their operational state. **Returns:** Returns a JSON array of supported chains, each with an id, name, and aliases array; includes Ethereum, BNB Chain, Polygon, Avalanche, Arbitrum, and Solana. **Example:** `GET https://api.paysponge.com/x402/purchase/svc_d6tc4d89rramggb4m/chains` --- ### `fetch-polymarket-wallet-positions` **Polymarket Wallet Positions** — Returns all Polymarket positions held by a given wallet address, with pagination metadata. *Use when:* Use when an agent needs to retrieve the current Polymarket prediction market positions for a specific wallet address, such as to audit holdings, display a portfolio, or analyze exposure. *Not for:* Do not use for market-level order book data or global Polymarket statistics; use a market data endpoint instead. Not suitable for non-Polymarket on-chain positions. **Inputs:** - `wallet_address` (string, required) — The wallet address whose Polymarket positions should be fetched. Provided as a path parameter in the URL. **Returns:** Returns the normalized wallet_address, a positions array (empty if none held), and a pagination object with has_more, limit, and pagination_key fields. **Example:** `GET https://api.paysponge.com/x402/purchase/svc_d5y7k40sm2ntn45xr/polymarket/positions/wallet/0x402Feee072D655B85e08f1751AF9ddbCd249521f` --- ### `fetch-kalshi-markets` **Kalshi Markets** — Returns a paginated list of Kalshi prediction market contracts, each with ticker, title, timing, status, price, and volume fields. *Use when:* Use when an agent needs to browse or search available Kalshi prediction markets, retrieve market metadata (tickers, titles, open/close times, last price, volume), or iterate through markets using pagination. *Not for:* Do not use for placing trades or orders on Kalshi; this endpoint only retrieves market listings. Not suitable for real-time streaming price feeds — this is a single paginated snapshot. **Inputs:** - `amount` (number, required) — Payment amount in USDC atomic units sent via x402 paywall to authorize the request. **Returns:** Returns a markets array of up to 10 Kalshi contract objects (each with event_ticker, market_ticker, title, start/end/close times, status, last_price, volume) plus a pagination object with limit, offset, total, has_more, and pagination_key. **Example:** `GET https://api.paysponge.com/x402/purchase/svc_d5y7k40sm2ntn45xr/kalshi/markets` --- ### `fetch-onescales-url-list` **OneScales URL List** — Returns the full sitemap URL list for onescales.com, including up to 200 URLs with their change frequency and last-modified timestamps. *Use when:* Use when an agent needs a structured list of all publicly indexed URLs on onescales.com, such as for site crawling, content discovery, SEO analysis, or building a navigation index of the site. *Not for:* Do not use for crawling or indexing arbitrary third-party websites; this endpoint is specific to onescales.com only. Not suitable for real-time page content retrieval — returns URL metadata only, not page HTML. **Returns:** Returns a sitemap URL, a count of 200, and an array of onescales.com page URLs each with changefreq and optional lastmod fields. **Example:** `GET https://api.paysponge.com/x402/purchase/svc_d7y5tb8gh147se37m/url/onescales.com` ---