{"openapi":"3.1.0","info":{"title":"YourAITools Listings","version":"0.1.0","x-guidance":"POST https://api.youraitools.co/listing/v1/fast-track (or /v1/launch, /v1/featured) with JSON {\"tool_url\",\"name\",\"contact_email\",\"category\"} using any x402 client. An invalid body gets 400 before any payment; a valid one gets the 402 terms, then the paid retry returns {ref, status:\"received\", review_by}. Track it free at GET /v1/status/<ref>.","contact":{"email":"hello@youraitools.co","url":"https://youraitools.co"},"x-logo":{"url":"https://agentgate-source.pages.dev/icons/listing.png"},"description":"Paid listing services for youraitools.co, a directory of AI tools and x402 APIs, paid in USDC over x402: fast-track review ($19), Launch bundle ($49) and Featured for 30 days ($29). A service, not an API tool. Every submission is reviewed by a person for legitimacy and fit (a real, working AI tool or API that matches youraitools.co). Payment does not guarantee approval. If a paid submission is rejected, its status becomes refund_pending and the full amount is refunded manually in USDC to the address that paid, on the same network, within 3 business days. Refunds are sent by hand, not automatically. Fast-track: review within 24 hours of payment. Launch: review within 24 hours. Featured: review within 48 hours. If we miss the review window, you can ask for a refund at hello@youraitools.co. \"Featured\" means placement on youraitools.co (Featured badge, pinned in its category, labelled as paid placement) for 30 days from approval. It is placement on our site only. Newsletter mention (Launch only): one line in the YourAITools newsletter, sent only once the newsletter has subscribers. Today it has none, so this may come later or not at all; it is not refundable on its own. We make no promise of traffic, clicks, sign-ups, rankings or revenue. youraitools.co is a small, new directory. Your contact email is used only to reach you about this submission. It is never shown publicly or on the status page. We can remove a listing that later turns out to be a scam, malware or illegal; no refund in that case."},"servers":[{"url":"https://api.youraitools.co/listing"}],"externalDocs":{"description":"Source and docs","url":"https://agentgate-source.pages.dev/x402-listing/"},"paths":{"/v1/fast-track":{"post":{"operationId":"listing_fast_track","summary":"Fast-track review: 19.00 USDC","description":"Your tool is reviewed within 24 hours of payment (the free queue is reviewed in the normal daily run) and, if approved, published on youraitools.co. Refunded in USDC if rejected. Reviewed for legitimacy and fit; payment does not guarantee approval. Rejected = refunded manually in USDC to the paying address on the same network within 3 business days. Featured = placement on youraitools.co for 30 days. No traffic or revenue promises.","tags":["paid"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"19.00"},"protocols":[{"x402":{}}]},"x-x402":{"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F","amount":"19000000","assetSymbol":"USDC","x402Versions":[2,1],"networks":[{"network":"eip155:8453","name":"Base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:137","name":"Polygon","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:42161","name":"Arbitrum One","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","name":"Solana","asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","symbol":"USDC","payTo":"FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte"}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["tool_url","name","contact_email","category"],"additionalProperties":true,"properties":{"tool_url":{"type":"string","format":"uri","maxLength":500,"description":"Public https URL of the tool, API or its docs","example":"https://example.com"},"name":{"type":"string","minLength":2,"maxLength":80,"example":"Example Tool"},"contact_email":{"type":"string","format":"email","maxLength":254,"description":"Only used to contact you about this submission; never shown publicly","example":"you@example.com"},"category":{"type":"string","minLength":2,"maxLength":48,"example":"x402 API"},"description":{"type":"string","maxLength":600,"description":"Optional: one or two sentences on what it does"},"notes":{"type":"string","maxLength":1000,"description":"Optional: anything the reviewer should know (pricing, x402 endpoint, launch date)"}}}}}},"responses":{"200":{"description":"Paid and settled: submission received","content":{"application/json":{"schema":{"type":"object","properties":{"ref":{"type":"string","pattern":"^LST-[0-9A-HJKMNP-TV-Z]{10}$"},"status":{"type":"string","enum":["received"]},"tier":{"type":"string"},"review_by":{"type":"string","format":"date-time"},"status_url":{"type":"string"},"payment":{"type":"object"},"terms":{"type":"string"}}}}}},"400":{"description":"Invalid body (checked before payment, so no 402 and never charged)"},"402":{"description":"Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body); returned for a valid body, an empty body or {}"},"503":{"description":"Storage unavailable (never charged)"}}}},"/v1/launch":{"post":{"operationId":"listing_launch","summary":"Launch bundle: 49.00 USDC","description":"Fast-track review within 24 hours, plus 30 days of Featured placement on youraitools.co once approved, plus one line in the YourAITools newsletter once it has subscribers (it has none yet). Refunded in USDC if rejected. Reviewed for legitimacy and fit; payment does not guarantee approval. Rejected = refunded manually in USDC to the paying address on the same network within 3 business days. Featured = placement on youraitools.co for 30 days. No traffic or revenue promises.","tags":["paid"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"49.00"},"protocols":[{"x402":{}}]},"x-x402":{"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F","amount":"49000000","assetSymbol":"USDC","x402Versions":[2,1],"networks":[{"network":"eip155:8453","name":"Base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:137","name":"Polygon","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:42161","name":"Arbitrum One","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","name":"Solana","asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","symbol":"USDC","payTo":"FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte"}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["tool_url","name","contact_email","category"],"additionalProperties":true,"properties":{"tool_url":{"type":"string","format":"uri","maxLength":500,"description":"Public https URL of the tool, API or its docs","example":"https://example.com"},"name":{"type":"string","minLength":2,"maxLength":80,"example":"Example Tool"},"contact_email":{"type":"string","format":"email","maxLength":254,"description":"Only used to contact you about this submission; never shown publicly","example":"you@example.com"},"category":{"type":"string","minLength":2,"maxLength":48,"example":"x402 API"},"description":{"type":"string","maxLength":600,"description":"Optional: one or two sentences on what it does"},"notes":{"type":"string","maxLength":1000,"description":"Optional: anything the reviewer should know (pricing, x402 endpoint, launch date)"}}}}}},"responses":{"200":{"description":"Paid and settled: submission received","content":{"application/json":{"schema":{"type":"object","properties":{"ref":{"type":"string","pattern":"^LST-[0-9A-HJKMNP-TV-Z]{10}$"},"status":{"type":"string","enum":["received"]},"tier":{"type":"string"},"review_by":{"type":"string","format":"date-time"},"status_url":{"type":"string"},"payment":{"type":"object"},"terms":{"type":"string"}}}}}},"400":{"description":"Invalid body (checked before payment, so no 402 and never charged)"},"402":{"description":"Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body); returned for a valid body, an empty body or {}"},"503":{"description":"Storage unavailable (never charged)"}}}},"/v1/featured":{"post":{"operationId":"listing_featured","summary":"Featured, 30 days: 29.00 USDC","description":"Reviewed within 48 hours of payment (tools not yet listed are reviewed first) and, if approved, shown as Featured (badge, pinned in its category, marked as paid placement) on youraitools.co for 30 days. Refunded in USDC if rejected. Reviewed for legitimacy and fit; payment does not guarantee approval. Rejected = refunded manually in USDC to the paying address on the same network within 3 business days. Featured = placement on youraitools.co for 30 days. No traffic or revenue promises.","tags":["paid"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"29.00"},"protocols":[{"x402":{}}]},"x-x402":{"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F","amount":"29000000","assetSymbol":"USDC","x402Versions":[2,1],"networks":[{"network":"eip155:8453","name":"Base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:137","name":"Polygon","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:42161","name":"Arbitrum One","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","name":"Solana","asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","symbol":"USDC","payTo":"FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte"}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["tool_url","name","contact_email","category"],"additionalProperties":true,"properties":{"tool_url":{"type":"string","format":"uri","maxLength":500,"description":"Public https URL of the tool, API or its docs","example":"https://example.com"},"name":{"type":"string","minLength":2,"maxLength":80,"example":"Example Tool"},"contact_email":{"type":"string","format":"email","maxLength":254,"description":"Only used to contact you about this submission; never shown publicly","example":"you@example.com"},"category":{"type":"string","minLength":2,"maxLength":48,"example":"x402 API"},"description":{"type":"string","maxLength":600,"description":"Optional: one or two sentences on what it does"},"notes":{"type":"string","maxLength":1000,"description":"Optional: anything the reviewer should know (pricing, x402 endpoint, launch date)"}}}}}},"responses":{"200":{"description":"Paid and settled: submission received","content":{"application/json":{"schema":{"type":"object","properties":{"ref":{"type":"string","pattern":"^LST-[0-9A-HJKMNP-TV-Z]{10}$"},"status":{"type":"string","enum":["received"]},"tier":{"type":"string"},"review_by":{"type":"string","format":"date-time"},"status_url":{"type":"string"},"payment":{"type":"object"},"terms":{"type":"string"}}}}}},"400":{"description":"Invalid body (checked before payment, so no 402 and never charged)"},"402":{"description":"Payment Required (x402 v2 terms in the PAYMENT-REQUIRED header, v1 terms in the body); returned for a valid body, an empty body or {}"},"503":{"description":"Storage unavailable (never charged)"}}}},"/v1/status/{ref}":{"get":{"operationId":"listing_status","summary":"Free: status of a paid submission (no email shown)","security":[],"parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string","pattern":"^LST-[0-9A-HJKMNP-TV-Z]{10}$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ref":{"type":"string"},"status":{"type":"string","enum":["received","approved","rejected","refund_pending","refunded"]},"tier":{"type":"string"},"name":{"type":"string"},"tool_url":{"type":"string"},"category":{"type":"string"},"received_at":{"type":"string"},"review_by":{"type":"string"},"decided_at":{"type":["string","null"]},"featured_from":{"type":"string"},"featured_until":{"type":"string"},"payment":{"type":["object","null"]},"refund":{"type":"object"}}}}}},"404":{"description":"Unknown ref"},"429":{"description":"Rate limited"}}}},"/v1/tiers":{"get":{"operationId":"listing_tiers","summary":"Free: tiers, prices and terms","security":[],"responses":{"200":{"description":"OK"}}}}},"x-x402-networks":[{"network":"eip155:8453","name":"Base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:137","name":"Polygon","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"eip155:42161","name":"Arbitrum One","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831","symbol":"USDC","payTo":"0x3c1A1E01e790Cd326495631B3b38Bd7068F08d6F"},{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","name":"Solana","asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","symbol":"USDC","payTo":"FH73WbbUe2UyNzfy72MJs5nT3NxyDf9GrqE7kzjL2Jte"}]}