Antimatter

POST/api/marketplace/providerSigned in session

One live application or provider per account. The operator approves it at /admin/marketplace; nothing reaches an endpoint before it is verified. Same origin. A 404 while the operator has the marketplace off.

Request body

application/json, required

Request body fields
Field	Type	What it is
namerequired	string	At most 80 characters.
base_urlrequired	string	An OpenAI compatible base URL over https whose host resolves only to public addresses; requests go to <base_url>/chat/completions through the outbound guard.
api_key	string	Sent to the endpoint as a bearer token; stored encrypted, never returned.
payout_addressrequired	string
data_retentionrequired	string	What the endpoint keeps. Until the operator verifies it, it counts as collects, which the default house data policy (deny) never routes to. One of "collects", "none", "zdr".
endpointsrequired	array of object
endpoints[].upstream_modelrequired	string	The id the provider's endpoint answers to.
endpoints[].model_idrequired	string	The catalog id the endpoint serves, or a new vendor/model id for a model only marketplace providers serve (listed in the catalog once verified).
endpoints[].name	string	A new listing's display name.
endpoints[].context_length	integer	At least 1024.
endpoints[].input_price_per_1mrequired	number	Dollars per 1M input tokens. At least 0.
endpoints[].output_price_per_1mrequired	number	Dollars per 1M output tokens. At least 0.
endpoints[].tools	boolean	Declares tool calling; verification measures it.
endpoints[].json	boolean	Declares JSON output; verification measures it.

Example

{
  "name": "string",
  "base_url": "string",
  "payout_address": "string",
  "data_retention": "collects",
  "endpoints": [
    {
      "upstream_model": "string",
      "model_id": "string",
      "input_price_per_1m": 0,
      "output_price_per_1m": 0
    }
  ]
}

Answer 201

The record.

Fields of the 201 answer
Field	Type	What it is
provider	object or null
provider.provider	object
provider.provider.id	integer
provider.provider.name	string or null
provider.provider.base_url	string or null
provider.provider.has_api_key	boolean
provider.provider.payout_address	string or null
provider.provider.data_retention	string	One of "collects", "none", "zdr".
provider.provider.retention_verified	boolean
provider.provider.status	string	One of "pending", "approved", "rejected", "suspended", "withdrawn", "erased".
provider.provider.status_reason	string or null
provider.provider.created_at	integer
provider.endpoints	array of object
provider.endpoints[].id	integer
provider.endpoints[].model_id	string
provider.endpoints[].upstream_model	string
provider.endpoints[].name	string or null
provider.endpoints[].context_length	integer or null
provider.endpoints[].input_price_per_1m	number
provider.endpoints[].output_price_per_1m	number
provider.endpoints[].tools	boolean
provider.endpoints[].json	boolean
provider.endpoints[].status	string	One of "pending", "verified", "paused", "removed".
provider.endpoints[].status_reason	string or null
provider.endpoints[].ttft_ms	integer or null
provider.endpoints[].quality	number or null	Task probes passed, 0 to 1.
provider.endpoints[].tools_ok	boolean or null
provider.endpoints[].json_ok	boolean or null
provider.endpoints[].verified_at	integer or null
provider.endpoints[].checked_at	integer or null
provider.earnings	object	Micro USD: owed is every accrual (the provider's price times each settled request's tokens), paid is every payout the operator recorded, balance the difference.
provider.earnings.owed_micros	integer
provider.earnings.paid_micros	integer
provider.earnings.balance_micros	integer
provider.traffic	array of object	The last 30 days, by UTC day.
provider.traffic[].day	string
provider.traffic[].requests	integer
provider.traffic[].prompt_tokens	integer
provider.traffic[].completion_tokens	integer
provider.traffic[].owed_micros	integer
provider.checks	array of object	The newest verification checks.
provider.checks[].endpoint_id	integer
provider.checks[].kind	string	One of "latency", "tools", "json", "code", "extract", "reason", "correctness", "usage".
provider.checks[].ok	boolean or null
provider.checks[].ms	integer or null
provider.checks[].detail	string or null
provider.checks[].at	integer
provider.payouts	array of object
provider.payouts[].micros	integer
provider.payouts[].tx_hash	string
provider.payouts[].chain	string or null
provider.payouts[].at	integer

Errors

400OpenAI shaped error.
401OpenAI shaped error.
403OpenAI shaped error.
404OpenAI shaped error.
409OpenAI shaped error.
413OpenAI shaped error.
429OpenAI shaped error.

Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.