{"openapi":"3.1.0","info":{"title":"Auction Price Intelligence API","version":"1.0.0","summary":"What is work like this actually clearing for in real auctions? Evidence-backed price ranges from observed auction outcomes, bids and budgets — never mixed up.","description":"Auction Price Intelligence answers one question for agents: what is comparable work actually clearing for in auctions? It reads auction data from independent sources (Freelancer public API, EU TED award notices, USAspending awards; a first-party Agent Reverse Auction feed when configured), keeps every price's evidence class (paid, completed, awarded, winning bid, bids, budgets) separate, selects comparables deterministically and computes statistics in exact decimals. Price: 0.053 USDC per charged query via x402 on Base mainnet. Operated by Active Life Hub LLC."},"servers":[{"url":"https://auctionpriceintelligence.online"}],"paths":{"/api/v1/price-intelligence":{"post":{"operationId":"getPriceIntelligence","summary":"Observed market price range for a task, from comparable auctions","description":"Without PAYMENT-SIGNATURE: validates and normalises the task (category, quantity, unit, language pair) and answers 402 with the x402 requirement, the price and the sources that would be consulted — free, nothing stored, no source called. AMBIGUOUS_TASK is refused here (422, free). With PAYMENT-SIGNATURE and Idempotency-Key: reads stored observations or refreshes the sources on demand and returns the estimate. SOURCE_UNAVAILABLE and UNABLE_TO_ESTIMATE are never charged. The same Idempotency-Key never charges twice; one payment authorises one query.","parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"Base64 x402 v2 payload (exact scheme, USDC)."},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,128}$"},"description":"Required with PAYMENT-SIGNATURE; reuse for retries."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceRequest"}}}},"responses":{"200":{"description":"Result. PAYMENT-RESPONSE header carries the settlement when charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceIntelligence"}}}},"400":{"description":"Invalid request (never charged)","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}}}}}}}},"402":{"description":"Payment required (quote) or payment invalid. PAYMENT-REQUIRED header carries the requirement.","content":{"application/json":{"schema":{"type":"object"}}}},"409":{"description":"Idempotency conflict, in progress, or payment replay","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}}}}}}}},"413":{"description":"Body over 16 KB","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}}}}}}}},"415":{"description":"Content-Type must be application/json","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}}}}}}}},"422":{"description":"AMBIGUOUS_TASK, unknown category or unit (never charged); details.candidates lists categories","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}}}}}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}}}}}}}},"503":{"description":"Not configured or payment provider unavailable (nothing charged)","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}}}}}}}}}}},"/api/v1/queries/{id}":{"get":{"operationId":"getQuery","summary":"Retrieve a paid result (free; the stored snapshot, never recomputed)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^apq_[0-9a-f]{52}$"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"Bearer <Idempotency-Key of the paid request>"}],"responses":{"200":{"description":"Stored result (cache_status STORED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceIntelligence"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}}}}}}}},"410":{"description":"Retention elapsed","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}}}}}}}}}}},"/api/v1/queries/{id}/comparables":{"get":{"operationId":"getComparables","summary":"Every comparable used, with provenance (free)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Comparables snapshot","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}}}}}}}}}}},"/api/v1/markets/{category}":{"get":{"operationId":"getMarket","summary":"Static market coverage for one category (free; statistics require a query)","parameters":[{"name":"category","in":"path","required":true,"schema":{"type":"string","enum":["translation","interpretation","transcription","proofreading","content_writing","web_extraction","web_research","lead_generation","data_entry","data_processing","data_analysis","data_annotation","document_conversion","image_processing","graphic_design","video_editing","voice_over","software_development","website_development","chatbot_development","machine_learning"]}}],"responses":{"200":{"description":"Category coverage","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown category"}}}},"/api/v1/coverage":{"get":{"operationId":"getCoverage","summary":"Categories, sources, currencies, languages (free, static)","responses":{"200":{"description":"Coverage","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/pricing":{"get":{"operationId":"getPricing","summary":"Price and measured cost basis (free, static)","responses":{"200":{"description":"Pricing","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/health":{"get":{"operationId":"getHealth","summary":"Liveness (no database, no source, no provider)","responses":{"200":{"description":"OK"},"503":{"description":"Not configured"}}}}},"components":{"schemas":{"PriceRequest":{"type":"object","additionalProperties":false,"description":"Either {\"task\": \"free text\"} / {\"task\": {…}} or the same task fields at the top level.","properties":{"task":{"oneOf":[{"type":"string","maxLength":4000},{"type":"object","additionalProperties":false,"properties":{"description":{"type":"string","maxLength":4000,"description":"What work needs pricing, any language. Preserved verbatim."},"category":{"type":"string","enum":["translation","interpretation","transcription","proofreading","content_writing","web_extraction","web_research","lead_generation","data_entry","data_processing","data_analysis","data_annotation","document_conversion","image_processing","graphic_design","video_editing","voice_over","software_development","website_development","chatbot_development","machine_learning"],"description":"Optional; classified from the description when omitted."},"quantity":{"type":"number","exclusiveMinimum":0},"unit":{"type":"string","description":"One of word, character, page, url, website, product, record, lead, image, document, article, minute, hour, video, email, api_call, task (plurals accepted)."},"deadline_hours":{"type":"number"},"language":{"type":"string","description":"BCP 47 language of the description (optional)."},"source_language":{"type":"string","description":"Translation/interpretation: from (ISO 639-1)."},"target_language":{"type":"string","description":"Translation/interpretation: into (ISO 639-1)."},"pricing_basis":{"type":"string","enum":["fixed","hourly"],"description":"Default: detected (\"per hour\"…) else fixed."},"quality":{"type":"string","maxLength":200},"constraints":{"type":"array","items":{"type":"string","maxLength":200},"maxItems":10}}}]},"description":{"type":"string","maxLength":4000,"description":"What work needs pricing, any language. Preserved verbatim."},"category":{"type":"string","enum":["translation","interpretation","transcription","proofreading","content_writing","web_extraction","web_research","lead_generation","data_entry","data_processing","data_analysis","data_annotation","document_conversion","image_processing","graphic_design","video_editing","voice_over","software_development","website_development","chatbot_development","machine_learning"],"description":"Optional; classified from the description when omitted."},"quantity":{"type":"number","exclusiveMinimum":0},"unit":{"type":"string","description":"One of word, character, page, url, website, product, record, lead, image, document, article, minute, hour, video, email, api_call, task (plurals accepted)."},"deadline_hours":{"type":"number"},"language":{"type":"string","description":"BCP 47 language of the description (optional)."},"source_language":{"type":"string","description":"Translation/interpretation: from (ISO 639-1)."},"target_language":{"type":"string","description":"Translation/interpretation: into (ISO 639-1)."},"pricing_basis":{"type":"string","enum":["fixed","hourly"],"description":"Default: detected (\"per hour\"…) else fixed."},"quality":{"type":"string","maxLength":200},"constraints":{"type":"array","items":{"type":"string","maxLength":200},"maxItems":10},"currency":{"type":"string","enum":["USD","USDC","EUR","GBP","CAD","AUD","INR","JPY","PLN","CHF"],"default":"USD","description":"Reporting currency. USDC is reported only from USDC observations; otherwise USD with an explicit note."},"convert_currencies":{"type":"boolean","default":true,"description":"Convert fiat observations with ECB reference rates (provenance on each)."},"lookback":{"type":"string","enum":["auto","24h","7d","30d","90d","1y","all"],"default":"auto"},"market":{"type":"string","enum":["auto","agent_marketplace","freelance_marketplace","public_procurement"],"default":"auto","description":"Market segment for the primary estimate; others are still reported in distributions."},"include_outliers":{"type":"boolean","default":false},"role":{"type":"string","enum":["customer","executor"],"description":"Only changes the interpretation text."}}},"PriceIntelligence":{"type":"object","required":["query_id","status","currency","sample_size","confidence","evidence_mix","comparables","sources","freshness","versions","payment"],"properties":{"query_id":{"type":"string"},"status":{"type":"string","enum":["PRICE_ESTIMATE_AVAILABLE","LIMITED_DATA","INSUFFICIENT_COMPARABLES","NO_COMPARABLE_DATA","AMBIGUOUS_TASK","SOURCE_UNAVAILABLE","UNABLE_TO_ESTIMATE"]},"currency":{"type":"string"},"estimated_market_price":{"type":["object","null"],"description":"low / median / high of the primary distribution (strings, exact decimals). null unless PRICE_ESTIMATE_AVAILABLE."},"sample_size":{"type":"integer"},"confidence":{"type":"string","enum":["HIGH","MEDIUM","LOW","INSUFFICIENT"]},"basis":{"type":"string","description":"COMPLETED_AND_AWARDED_AUCTIONS | AWARDED_AUCTIONS | WINNING_BIDS | BIDS_ON_COMPARABLE_AUCTIONS | RAW_COMPARABLES_ONLY | NONE"},"market":{"type":["object","null"],"description":"Primary distribution: segment, evidence_group, low/median/high, range_basis, recency_weighted_median, percentiles (n≥20), dispersion, outliers, unit, pricing_basis."},"confidence_factors":{"type":["object","null"]},"observed_period":{"type":"object"},"observation_window":{"type":"object"},"evidence_mix":{"type":"object","description":"Counts per evidence class: completed_paid, completed, awarded, closed_winning_bid, historical_bids, active_bids, customer_budget, asking_price."},"distributions":{"type":"array","description":"Every (segment, evidence group) with ≥5 points; groups are never pooled."},"by_marketplace":{"type":"array"},"by_mechanism":{"type":"array"},"by_currency":{"type":"array"},"unit_prices":{"type":["object","null"]},"trend":{"type":["object","null"],"description":"RISING | FALLING | STABLE | INSUFFICIENT_DATA, 30-day median vs previous 30 days."},"competition":{"type":"object"},"price_reduction":{"type":"object"},"comparables":{"type":"array","description":"Top 25 comparables with price type, evidence class, original amount/currency, conversion, similarity, outlier label, source link."},"comparables_total":{"type":"integer"},"comparables_url":{"type":"string"},"sources":{"type":"array"},"freshness":{"type":"object","description":"generated_at, latest_observation_at, oldest_used_observation_at, per-source fetched_at."},"currency_handling":{"type":"object"},"interpretation":{"type":"object"},"unknowns":{"type":"array","items":{"type":"string"}},"limitations":{"type":"array","items":{"type":"string"}},"versions":{"type":"object","description":"pricing_model_version, normalization_version, stats_version"},"payment":{"type":"object"}}}}},"x-pricing":{"amount":"0.053","currency":"USDC","unit":"query","version":"apri-cost-plus-2026-10-01-v1"}}