{"version":"2026-09-06","site":"https://bidglow.ai/","defaultLanguage":"en","documentation":"https://bidglow.ai/developers","openapi":"https://bidglow.ai/openapi.json","capabilities":{"publicQuotes":true,"publicHandoff":true,"freePublishing":true,"unattendedPayments":true,"storedPaymentMethods":false},"endpoints":{"capabilities":"/api/v1/agent/capabilities","quote":"/api/v1/agent/quote","freePublish":"/api/v1/agent/listings"},"agentGuide":"https://bidglow.ai/agent-guide.md","publishingPolicy":{"rulesVersion":"2026-09-06","explicitUserApprovalRequired":true,"approvalScope":"free_listing_publish","approvalPolicy":"Use existing explicit authorization for this destination or a bounded set of destinations. Do not ask again within that scope. Building a website or asking for suggestions alone is not publication authorization. Free authorization never permits payment.","credentialHandling":"The agent generates and privately stores submission credentials and management receipts; the customer need not type or handle them.","httpRequestExample":{"exampleOnly":true,"method":"POST","path":"/api/v1/agent/listings","headers":{"Content-Type":"application/json","User-Agent":"BidGlowAgent/1.0","Idempotency-Key":"<fresh-random-UUIDv4>","X-Submission-Secret":"<fresh-random-32-byte-hex>"},"body":{"destination":"https://your-site.example/","category":"Developer Tools","approval":{"scope":"free_listing_publish","userApproved":true,"rulesVersion":"2026-09-06"}}},"transportNote":"HTTP uses a nested approval object and credential headers; MCP publish_free uses flat arguments. Never copy one transport payload into the other.","serverToServer":true,"requestBodyMaxBytes":4096,"idempotencyHeader":"Idempotency-Key","proofHeader":"X-Submission-Secret","resume":"Repeat the identical POST with the same key, secret and body. A replay does not renew a listing.","domainOwnershipVerified":false,"contentReviewRequired":true,"paidRankingChanged":false,"limits":{"requestsPerTenMinutesPerIp":30,"newAttemptsPerDayPerIp":4,"newAttemptsPerDayPerHost":4,"newAttemptsPerDayGlobal":100}},"currency":"usd","amountUnit":"integer_usd_target","minimumNewTarget":5,"minimumIncrease":1,"categories":[{"id":"SEO & AI Visibility","label":"SEO & AI Visibility"},{"id":"AI Agents & Infrastructure","label":"AI Agents & Infrastructure"},{"id":"AI Media Generation","label":"AI Media Generation"},{"id":"Marketing & Advertising","label":"Marketing & Advertising"},{"id":"Developer Tools","label":"Developer Tools"},{"id":"Productivity & Personal Tools","label":"Productivity & Personal Tools"},{"id":"Personal Profiles","label":"Personal Profiles"},{"id":"Design & Creative","label":"Design & Creative"},{"id":"Social & Creator Tools","label":"Social & Creator Tools"},{"id":"Writing & Content","label":"Writing & Content"},{"id":"Sales & Lead Generation","label":"Sales & Lead Generation"},{"id":"Business, Finance & Legal","label":"Business, Finance & Legal"},{"id":"Games & Entertainment","label":"Games & Entertainment"},{"id":"Education & Learning","label":"Education & Learning"},{"id":"Health, Fitness & Wellness","label":"Health, Fitness & Wellness"},{"id":"E-commerce & Retail","label":"E-commerce & Retail"},{"id":"Directories & Discovery","label":"Directories & Discovery"},{"id":"Hiring, Jobs & Careers","label":"Hiring, Jobs & Careers"},{"id":"Audio, Voice & Podcasts","label":"Audio, Voice & Podcasts"},{"id":"Crypto, Web3 & Investing","label":"Crypto, Web3 & Investing"},{"id":"Agencies, Studios & Services","label":"Agencies, Studios & Services"},{"id":"Security, Privacy & Compliance","label":"Security, Privacy & Compliance"},{"id":"Travel, Local & Lifestyle","label":"Travel, Local & Lifestyle"},{"id":"Media & News","label":"Media & News"},{"id":"Domains & Web Assets","label":"Domains & Web Assets"},{"id":"Leaderboards & Attention Markets","label":"Leaderboards & Attention Markets"},{"id":"Real Estate","label":"Real Estate"},{"id":"Other","label":"Other"}],"boards":["all","today"],"ranking":"Stripe-confirmed live payments only; clicks and promotion points do not affect rank.","discovery":{"available":false,"submissionEndsAt":"2026-10-26T00:01:00-07:00","displayDays":60,"paidRanking":false},"paymentPolicy":{"humanConfirmationRequired":true,"quotesCreateNoCharge":true,"rankNotGuaranteed":true,"checkoutMethods":["card","crypto"],"cryptoCheckout":{"supportsUSDC":true,"walletConfirmationRequired":true,"availability":"Stripe determines eligible tokens, wallets and networks.","maximumChargeAmountCents":1000000},"existingListingOwnerRequired":true,"finalQuoteRecalculatedAtCheckout":true,"scope":"Stripe Checkout; for wallet-authorized unattended USDC use usdcPayments","unattendedUsdcAvailable":true,"walletAuthorizationRequired":true},"usdcPayments":{"dtoVersion":"bidglow.usdc-order.v2","status":"live","method":"POST","path":"/api/v1/agent/usdc-orders","contentType":"application/json","auth":"ownerToken (listing management token from free publishing, UUID) in the JSON body","walletNeutral":true,"unattended":true,"humanConfirmationRequired":false,"rail":"stripe_deposit_mode","network":"base","token":"USDC","decimals":6,"request":{"required":["purchaseId (client UUID, idempotency key)","listingId","ownerToken","targetBid (whole dollars)","board ('all'|'today')"],"optional":["signedOrder (boolean)"]},"response":["purchaseId","paymentIntentId","status","network","chainId","token","tokenContract","depositAddress","amountAtomic","amountUsdc","amountCents","expiresAt","statusUrl","listingId","board","targetBid"],"amountRule":"exact","rules":["Pay the EXACT amountAtomic of USDC on Base to depositAddress, in one transfer, before expiresAt (unix seconds; at most 30 minutes after creation).","depositAddress is issued by Stripe for this order only (it differs between orders). Use it only for this order and only before expiresAt; GET statusUrl returns it again. At most one open order exists per exact amount (409 AMOUNT_SLOT_BUSY otherwise).","Overpayment, underpayment, split, late or duplicate payments are not matched automatically: they go to manual review. There are no automatic refunds.","Ranking changes only after a signature-verified Stripe payment_intent.succeeded webhook; poll statusUrl until fulfilled.","Retry the same request with the same purchaseId after network errors; it never creates a second order."],"depositAddressSource":"Returned by BidGlow's own server-side, authenticated Stripe API call for this order's PaymentIntent. Never reuse an address from an earlier order.","rateLimits":{"create":"10 requests/minute per client","status":"60 requests/minute per client"},"orderTtlSecondsMax":1800,"statuses":["open","processing","succeeded","fulfilled","expired","canceled","manual_review"],"terminalStatuses":["fulfilled","expired","canceled","manual_review"],"errors":{"400":"INVALID_* / UNKNOWN_FIELD / AMOUNT_ABOVE_CAP","401":"OWNER_TOKEN_REQUIRED (status)","403":"NOT_LISTING_OWNER","404":"LISTING_NOT_FOUND / ORDER_NOT_FOUND","409":"AMOUNT_SLOT_BUSY (retryAfterSeconds) / ORDER_TERMS_MISMATCH / PURCHASE_MODE_MISMATCH / ORDER_FAILED / ORDER_NEEDS_REVIEW","410":"ORDER_EXPIRED","413":"BODY_TOO_LARGE","415":"UNSUPPORTED_MEDIA_TYPE","429":"RATE_LIMITED","503":"USDC_DEPOSIT_UNAVAILABLE / STRIPE_OUTCOME_UNKNOWN (retry same purchaseId)"},"refunds":"No automatic refunds. Any refund is a manual, owner-approved decision.","rankingRule":"Ranks only after a signature-verified Stripe payment_intent.succeeded webhook.","notSameAs":"/api/v1/agent/usdc/orders (experimental EIP-3009 machine rail)","statusEndpoint":{"method":"GET","path":"/api/v1/agent/usdc-orders/{purchaseId}","auth":"Authorization: Bearer <ownerToken>","dtoMinor":"1.6","pollIntervalSeconds":10,"statuses":["open","processing","succeeded","fulfilled","expired","canceled","manual_review"]},"docs":{"openapi":"/openapi.json","guide":"/agent-guide.md","llms":"/llms.txt"},"chainId":8453,"tokenContract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","maxAmountCents":600,"signedOrder":{"optional":true,"available":true,"request":"Opt in with ?signedOrder=1 or JSON {\"signedOrder\":true}. Never needed to pay.","paymentOrder":"EIP-712 AgentWalletPaymentOrder v5","paymentOrderDomainVersion":"5","verifyingContract":"0x05320bed08309f66316f7d73e2d0be110400fbb2","paymentOrderPayer":"0x0000000000000000000000000000000000000000"},"kipurseV51":{"available":true,"dtoVersion":"bidglow.usdc-deposit-order.v2","via":"signedOrderUrl","chains":[{"chainId":84532,"verifier":"0x79E052e601Adb6762965B4AF75e6896891EB10F5"}]}},"stripeUsdcDepositOrders":{"dtoVersion":"bidglow.usdc-order.v2","status":"live","method":"POST","path":"/api/v1/agent/usdc-orders","contentType":"application/json","auth":"ownerToken (listing management token from free publishing, UUID) in the JSON body","walletNeutral":true,"unattended":true,"humanConfirmationRequired":false,"rail":"stripe_deposit_mode","network":"base","token":"USDC","decimals":6,"request":{"required":["purchaseId (client UUID, idempotency key)","listingId","ownerToken","targetBid (whole dollars)","board ('all'|'today')"],"optional":["signedOrder (boolean)"]},"response":["purchaseId","paymentIntentId","status","network","chainId","token","tokenContract","depositAddress","amountAtomic","amountUsdc","amountCents","expiresAt","statusUrl","listingId","board","targetBid"],"amountRule":"exact","rules":["Pay the EXACT amountAtomic of USDC on Base to depositAddress, in one transfer, before expiresAt (unix seconds; at most 30 minutes after creation).","depositAddress is issued by Stripe for this order only (it differs between orders). Use it only for this order and only before expiresAt; GET statusUrl returns it again. At most one open order exists per exact amount (409 AMOUNT_SLOT_BUSY otherwise).","Overpayment, underpayment, split, late or duplicate payments are not matched automatically: they go to manual review. There are no automatic refunds.","Ranking changes only after a signature-verified Stripe payment_intent.succeeded webhook; poll statusUrl until fulfilled.","Retry the same request with the same purchaseId after network errors; it never creates a second order."],"depositAddressSource":"Returned by BidGlow's own server-side, authenticated Stripe API call for this order's PaymentIntent. Never reuse an address from an earlier order.","rateLimits":{"create":"10 requests/minute per client","status":"60 requests/minute per client"},"orderTtlSecondsMax":1800,"statuses":["open","processing","succeeded","fulfilled","expired","canceled","manual_review"],"terminalStatuses":["fulfilled","expired","canceled","manual_review"],"errors":{"400":"INVALID_* / UNKNOWN_FIELD / AMOUNT_ABOVE_CAP","401":"OWNER_TOKEN_REQUIRED (status)","403":"NOT_LISTING_OWNER","404":"LISTING_NOT_FOUND / ORDER_NOT_FOUND","409":"AMOUNT_SLOT_BUSY (retryAfterSeconds) / ORDER_TERMS_MISMATCH / PURCHASE_MODE_MISMATCH / ORDER_FAILED / ORDER_NEEDS_REVIEW","410":"ORDER_EXPIRED","413":"BODY_TOO_LARGE","415":"UNSUPPORTED_MEDIA_TYPE","429":"RATE_LIMITED","503":"USDC_DEPOSIT_UNAVAILABLE / STRIPE_OUTCOME_UNKNOWN (retry same purchaseId)"},"refunds":"No automatic refunds. Any refund is a manual, owner-approved decision.","rankingRule":"Ranks only after a signature-verified Stripe payment_intent.succeeded webhook.","notSameAs":"/api/v1/agent/usdc/orders (experimental EIP-3009 machine rail)","statusEndpoint":{"method":"GET","path":"/api/v1/agent/usdc-orders/{purchaseId}","auth":"Authorization: Bearer <ownerToken>","dtoMinor":"1.6","pollIntervalSeconds":10,"statuses":["open","processing","succeeded","fulfilled","expired","canceled","manual_review"]},"docs":{"openapi":"/openapi.json","guide":"/agent-guide.md","llms":"/llms.txt"},"chainId":8453,"tokenContract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","maxAmountCents":600,"signedOrder":{"optional":true,"available":true,"request":"Opt in with ?signedOrder=1 or JSON {\"signedOrder\":true}. Never needed to pay.","paymentOrder":"EIP-712 AgentWalletPaymentOrder v5","paymentOrderDomainVersion":"5","verifyingContract":"0x05320bed08309f66316f7d73e2d0be110400fbb2","paymentOrderPayer":"0x0000000000000000000000000000000000000000"},"kipurseV51":{"available":true,"dtoVersion":"bidglow.usdc-deposit-order.v2","via":"signedOrderUrl","chains":[{"chainId":84532,"verifier":"0x79E052e601Adb6762965B4AF75e6896891EB10F5"}]}}}