Capydra API
REST API v1 and an MCP server for programs and AI assistants. Machine-readable: /openapi.json (OpenAPI 3.1).
Selling through Eneba or Driffle already? Coming from Eneba or Driffle maps what you know to our calls.
Getting started
- Sign in and open /account/api-keys. Create a key: name, scope (buyer or seller), and the sandbox flag. There you accept the two withdrawal-waiver sentences once (terms version 2026-11-16.1); every order made with the key refers to that acceptance.
- The key is shown once. Keep it in an environment variable:
export OMK_KEY=omk_test_... - Send it as
Authorization: Bearer $OMK_KEY.
- Sandbox keys (
omk_test_) see only sandbox orders and their test payments are approved at once. Live keys (omk_live_) see only live orders. An order of the other kind answers 404. - Scopes: buyer keys search, order and fetch keys. Seller keys can also manage their own offers, prices and stock. No API key carries admin rights.
- Money is integer euro cents. Prices already include the service fee (
total_centsis what the buyer pays). - Rate limit: 120 requests per key per 60 seconds, REST and MCP together. Over it: HTTP 429,
{"error":"rate_limited","retry_after":...}. - Errors are JSON:
{"error":"order_not_found","message":"..."}with a fitting HTTP status. - Keys (the product keys you buy) are shown by
POST /api/v1/orders/{id}/revealor the MCP toolget_order. Every view is logged with time, IP, user agent and channel.
MCP (Model Context Protocol)
Endpoint: POST https://capydra.com/mcp, Streamable HTTP, stateless. Send Accept: application/json, text/event-stream.
Supported: initialize, notifications/initialized, tools/list, tools/call, ping (and the 2026-07-28 per-request form).
Answers come as one server-sent event (data: {...}) or JSON. Without a key the answer is 401.
Calling a tool: {"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_products","arguments":{"query":"elden"}}}
| Tool | Scope | What it does | Arguments (* required) |
|---|---|---|---|
search_products | buyer | Search the Capydra catalogue (games, DLC, gift cards, subscriptions, software keys). Each product shows its cheapest offer with the all-in price for one unit (service fee included), in euro cents. | query, category, type, platform, region, limit, offset |
get_product | buyer | One product with every offer you can buy: seller, stock, and the all-in price for one unit in euro cents. Use an offer id from here with create_order. | product_id* |
create_order | buyer | Orders an offer for your account. The two withdrawal-waiver sentences you accepted when the API key was made are stored on the order. With a sandbox key (omk_test_) the test payment is approved at once; with a live key the answer carries pay_url, where the payment is made. Keys are fetched with get_order once delivered. | offer_id*, qty, coupon_code, player_id, server, trade_url, type_notice |
get_order | buyer | Status of one of your orders. Once delivered, the first call returns the product keys and logs the view (this is the delivery: an instant refund is no longer possible afterwards). Later calls return keys: null; set show_keys to true to see them again (every view is logged). | order_id*, show_keys |
list_offers | seller | Your offers with status, stock, your net price, the commission and what the buyer pays (euro cents). | status |
create_offer | seller | Creates your offer for a catalogue product. price_cents is what you want to receive per unit; the answer shows the commission and the buyer price. One offer per product; change it with update_price. | product_id*, price_cents*, fulfilment, status, hand_delivery_hours, hand_amount |
upload_stock | seller | Adds product keys to one of your manual offers. Keys are stored encrypted and never shown back; a key the platform already knows (from any seller) is refused and counted as a duplicate. | offer_id*, keys* |
update_price | seller | Sets a new "price I want to receive" for one of your offers; commission and buyer price are recomputed. | offer_id*, price_cents* |
get_limits | seller | Your seller level, what you may do per day (offers, keys, highest price), what you used, offers on hold, the API rate limit, the sandbox status of your declared-stock API and the caps of the bulk tools. Call this before bulk work. | |
match_products | seller | Finds our product id for rows of your supplier feed: ean, steam_app_id, sku or name, with platform and region. confidence exact or high gives best; none gives candidates and a reason. Never list on a guess. | items* |
bulk_create_offers | seller | Creates up to 20 offers in one call. DRY RUN BY DEFAULT: nothing is written unless you send dry_run: false. First call it with dry_run (or leave it out), show the person the results, then call again with dry_run: false. Each item: product_id (or ean / steam_app_id / sku / name with platform and region), price_cents you want to receive. Every item gets its own result; one bad item never stops the others. | dry_run, items* |
bulk_update_prices | seller | Changes the price of up to 50 of your offers. DRY RUN BY DEFAULT: nothing is written unless you send dry_run: false. The dry run shows the new buyer prices and any review hold. | dry_run, items* |
upload_stock_job | seller | Big key upload (up to 10000 keys) as a background job for one of your manual offers. Answers at once with a job id; check it with get_job. Bad lines become per-item errors by index; keys are never shown back. | offer_id*, keys* |
get_job | seller | Status of one of your upload jobs: counts, the first per-item errors, the key batch and orders delivered from it. | job_id* |
Endpoints
account catalogue orders seller webhooks mcp admin other
account
Your key and the legal texts.
GET /api/v1/legal/waivers
The two § 356 Abs. 5 BGB waiver sentences and the reveal consent, with the terms version.
Auth: none
| Parameter | In | Description |
|---|---|---|
lang | query | de (default) or en. |
curl -s "https://capydra.com/api/v1/legal/waivers?lang=en"
GET /api/v1/me
Who am I: user, key scope, sandbox flag and the stored waiver acceptance.
Auth: API key (Bearer) or signed-in session
curl -s "https://capydra.com/api/v1/me" -H "Authorization: Bearer $OMK_KEY"
POST /api/v1/keys/rotate
Rotate the key you call with: a new key with the same name, scope, mode, permissions, IP allowlist and expiry length (in this answer only). The old key keeps working for overlap_hours (default 24, max 168), then expires. Keys expire after 365 days unless chosen otherwise (1 to 730 days on /account/api-keys); GET /api/v1/me shows expires_at, permissions and ip_allowlist. Do not send an Idempotency-Key here.
Auth: API key (Bearer) or signed-in session
curl -s -X POST "https://capydra.com/api/v1/keys/rotate" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{"overlap_hours":24}'
POST /api/v1/keys/signing
Require signed requests for the key you call with (HTTP Message Signatures, RFC 9421, Ed25519). Send the base64 of your 32-byte Ed25519 public key. From then on every request with this key needs Content-Digest (when there is a body), Signature-Input: sig1=("@method" "@target-uri" "content-digest");created=<unix s>;nonce="<random>";keyid="<key id>";alg="ed25519" and Signature: sig1=:<base64>:, created within 5 minutes, each nonce once. Turning it off needs the keys page while signed in.
Auth: API key (Bearer) or signed-in session
curl -s -X POST "https://capydra.com/api/v1/keys/signing" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{"public_key":"MCowBQYDK2VwAyEA...(base64 of the 32 raw bytes)"}'
catalogue
Products, offers and prices.
GET /api/v1/quote
Price quote after every price modifier (price breaks, membership, coupon).
Auth: none
| Parameter | In | Description |
|---|---|---|
offer_id | query | Offer id. |
qty | query | Quantity. |
coupon | query | Coupon code. |
curl -s "https://capydra.com/api/v1/quote?offer_id=off_house_elden_ring&qty=1"
GET /api/v1/trust/sellers/{id}
Public trust summary of a seller: level, badge, completed orders, volume tier, payout hold.
Auth: none
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s "https://capydra.com/api/v1/trust/sellers/sel_house"
GET /api/v1/categories
Product categories.
Auth: API key (Bearer) or signed-in session
curl -s "https://capydra.com/api/v1/categories" -H "Authorization: Bearer $OMK_KEY"
GET /api/v1/products
Search products. Each carries its cheapest offer with the all-in price (service fee included).
Auth: API key (Bearer) or signed-in session
| Parameter | In | Description |
|---|---|---|
query | query | Words in name or platform. |
category | query | Category slug. |
type | query | game, dlc, giftcard, subscription, software, game_currency, account_topup, game_gold, skin, account, ai_subscription, ai_credit. |
platform | query | e.g. Steam. |
region | query | e.g. EU. |
limit | query | Page size, 1-50 (default 20). |
offset | query | Items to skip. |
curl -s "https://capydra.com/api/v1/products?query=elden" -H "Authorization: Bearer $OMK_KEY"
GET /api/v1/products/{id}
One product (id or slug) with every offer you can buy.
Auth: API key (Bearer) or signed-in session
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s "https://capydra.com/api/v1/products/elden-ring-steam-eu" -H "Authorization: Bearer $OMK_KEY"
GET /api/v1/products/{id}/offers
The offers of a product, cheapest all-in price first.
Auth: API key (Bearer) or signed-in session
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s "https://capydra.com/api/v1/products/prd_elden_ring/offers" -H "Authorization: Bearer $OMK_KEY"
GET /api/v1/offers/{id}
One offer with its price for a quantity.
Auth: API key (Bearer) or signed-in session
| Parameter | In | Description |
|---|---|---|
id * | path | string |
qty | query | Quantity to price (default 1). |
curl -s "https://capydra.com/api/v1/offers/off_house_elden_ring?qty=2" -H "Authorization: Bearer $OMK_KEY"
GET /api/v1/catalog/match
Find our product id from your supplier feed: ean, steam_app_id, sku or name, plus platform and region. confidence exact (EAN or SKU, one product) or high (Steam app id or name, with platform and region, one product left) gives best; none gives candidates and a reason (several_editions, send_platform_and_region, ...). Never list on a guess.
Auth: API key (Bearer) or signed-in session
| Parameter | In | Description |
|---|---|---|
ean | query | EAN-8/12/13/14. |
steam_app_id | query | Steam app id of the game. |
sku | query | Store or publisher SKU. |
name | query | Product name as in your feed. |
platform | query | Steam, Xbox, PlayStation, Nintendo Switch, GOG, EA app, ... |
region | query | EU, GLOBAL or DE. |
type | query | game, dlc, giftcard, subscription, software, game_currency, account_topup, game_gold, skin, account, ai_subscription, ai_credit. |
curl -s "https://capydra.com/api/v1/catalog/match?steam_app_id=990080&name=Hogwarts%20Legacy&platform=Steam®ion=EU" -H "Authorization: Bearer $OMK_KEY"
POST /api/v1/catalog/match:batch
Up to 100 match queries in one call, a result per item (as GET /api/v1/catalog/match).
Auth: API key (Bearer) or signed-in session
| Parameter | In | Description |
|---|---|---|
batch * | path | string |
curl -s -X POST "https://capydra.com/api/v1/catalog/match:batch" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{"items":[{"ref":"feed-1","ean":"5051892236921","platform":"Steam","region":"EU"},{"ref":"feed-2","name":"Forza Horizon 5","platform":"Steam","region":"GLOBAL"}]}'
orders
Buying, keys, refunds, evidence.
GET /api/v1/orders
Your orders, newest first. A sandbox key lists only sandbox orders, a live key only live ones.
Auth: API key (Bearer) or signed-in session
| Parameter | In | Description |
|---|---|---|
status | query | Only orders with this status. |
limit | query | Page size, 1-50 (default 20). |
offset | query | Items to skip. |
curl -s "https://capydra.com/api/v1/orders" -H "Authorization: Bearer $OMK_KEY"
POST /api/v1/orders
Order an offer. waiver1 and waiver2 must be true (or the exact sentences); with an API key the key's stored acceptance is referenced too, and the order is written in its language. auto_pay approves the test payment at once (sandbox keys, or test mode).
Auth: API key (Bearer) or signed-in session
curl -s -X POST "https://capydra.com/api/v1/orders" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{"offer_id":"off_house_elden_ring","qty":1,"waiver1":true,"waiver2":true,"auto_pay":true}'
GET /api/v1/orders/{id}
One order (no keys). pay_url is set while a live order waits for payment.
Auth: API key (Bearer) or signed-in session
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s "https://capydra.com/api/v1/orders/ord_xxxxxxxxxxxxxxxx" -H "Authorization: Bearer $OMK_KEY"
POST /api/v1/orders/{id}/reveal
Show the delivered keys. The first view needs consent: true; every view is logged (KEY_VIEWED).
Auth: API key (Bearer) or signed-in session
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s -X POST "https://capydra.com/api/v1/orders/ord_xxxxxxxxxxxxxxxx/reveal" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{"consent":true}'
POST /api/v1/orders/{id}/confirm
"Key works": confirms a delivered order.
Auth: API key (Bearer) or signed-in session
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s -X POST "https://capydra.com/api/v1/orders/ord_xxxxxxxxxxxxxxxx/confirm" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{}'
POST /api/v1/orders/{id}/refund
Instant full refund while no key was revealed.
Auth: API key (Bearer) or signed-in session
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s -X POST "https://capydra.com/api/v1/orders/ord_xxxxxxxxxxxxxxxx/refund" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{}'
GET /api/v1/orders/{id}/evidence
Evidence: stored waiver texts and every order event with IP, user agent, time, channel and terms version.
Auth: API key (Bearer) or signed-in session
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s "https://capydra.com/api/v1/orders/ord_xxxxxxxxxxxxxxxx/evidence" -H "Authorization: Bearer $OMK_KEY"
POST /api/v1/trust/reports
Report a problem with one of your orders: kind key_invalid, key_used or other; a key report needs a revealed key (otherwise use the instant refund).
Auth: API key (Bearer) or signed-in session
curl -s -X POST "https://capydra.com/api/v1/trust/reports" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{"order_id":"ord_xxxxxxxxxxxxxxxx","kind":"key_invalid","text":"Steam says the key is not valid."}'
seller
Seller-scope keys: offers, prices, stock, orders.
GET /api/v1/seller/limits
Your limits (offers, keys per day, open exposure, price pace) and the use of the last 24 hours, plus the API rate limit of this key.
Auth: seller-scope API key or signed-in seller
curl -s "https://capydra.com/api/v1/seller/limits" -H "Authorization: Bearer $OMK_SELLER_KEY"
POST /api/v1/seller/endpoint/verify-domain
Check the DNS TXT record that proves your delivery endpoint's domain is yours.
Auth: seller-scope API key or signed-in seller
curl -s -X POST "https://capydra.com/api/v1/seller/endpoint/verify-domain" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{}'
GET /api/v1/seller/sandbox
Sandbox certification status of your delivery endpoint (needed before live declared-stock orders).
Auth: seller-scope API key or signed-in seller
curl -s "https://capydra.com/api/v1/seller/sandbox" -H "Authorization: Bearer $OMK_SELLER_KEY"
POST /api/v1/seller/sandbox/certify
Run the sandbox test orders against your delivery endpoint now (at most a few runs per hour).
Auth: seller-scope API key or signed-in seller
curl -s -X POST "https://capydra.com/api/v1/seller/sandbox/certify" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{}'
GET /api/v1/seller/reports
Buyer reports on your orders with reply_until (48 hours after the report), can_reply and can_replace. If you neither answer nor send a replacement by then, the case goes to the shop owner, who decides without you (refund with your fee and a strike, or dismiss).
Auth: seller-scope API key or signed-in seller
curl -s "https://capydra.com/api/v1/seller/reports" -H "Authorization: Bearer $OMK_SELLER_KEY"
POST /api/v1/seller/reports/{id}/replace
Send replacement keys for a key report (exactly one per delivered key, once per order, within 48 hours). The report closes as replaced, the buyer gets a mail and sees the old key marked as replaced.
Auth: seller-scope API key or signed-in seller
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s -X POST "https://capydra.com/api/v1/seller/reports/rep_xxxxxxxxxxxxxxxx/replace" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{"keys":["AAAAA-BBBBB-CCCCC"]}'
GET /api/v1/trust/strikes
Your strikes with the statement of reasons (rule, action, until, automated).
Auth: seller-scope API key or signed-in seller
curl -s "https://capydra.com/api/v1/trust/strikes" -H "Authorization: Bearer $OMK_SELLER_KEY"
GET /api/v1/seller/offers
Your offers: status, stock, your net price, commission and buyer price.
Auth: seller-scope API key or signed-in seller
| Parameter | In | Description |
|---|---|---|
status | query | active, paused, draft or hidden. |
curl -s "https://capydra.com/api/v1/seller/offers" -H "Authorization: Bearer $OMK_SELLER_KEY"
POST /api/v1/seller/offers
Create an offer. price_cents is the price you want to receive per unit; the commission is added on top.
Auth: seller-scope API key or signed-in seller
curl -s -X POST "https://capydra.com/api/v1/seller/offers" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{"product_id":"prd_hogwarts","price_cents":1500,"fulfilment":"manual"}'
POST /api/v1/seller/offers:batch
Create up to 50 offers in one call. Each item runs the same checks as POST /api/v1/seller/offers and gets its own result (ok, or error and message); one bad item never stops the others. dry_run: true checks everything and writes nothing. Send an Idempotency-Key so a retry does not run twice. holds lists price_review or proof_review when an offer waits for a person. Instead of product_id an item can carry ean, steam_app_id, sku or name plus platform and region (see GET /api/v1/catalog/match): only a sure match (exact or high) lists, otherwise the item fails with no_confident_match and the candidates.
Auth: seller-scope API key or signed-in seller
| Parameter | In | Description |
|---|---|---|
batch * | path | string |
curl -s -X POST "https://capydra.com/api/v1/seller/offers:batch" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Idempotency-Key: listing-2026-11-07-001" -H "Content-Type: application/json" -d '{"dry_run":true,"items":[{"ref":"row-1","product_id":"prd_hogwarts","price_cents":1500},{"ref":"row-2","product_id":"prd_forza5","price_cents":1200,"status":"draft"}]}'
POST /api/v1/seller/prices:batch
Change the price of up to 100 of your offers in one call, with a result per item. Same price as now: unchanged, nothing written. dry_run: true shows the new buyer prices and holds and writes nothing.
Auth: seller-scope API key or signed-in seller
| Parameter | In | Description |
|---|---|---|
batch * | path | string |
curl -s -X POST "https://capydra.com/api/v1/seller/prices:batch" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Idempotency-Key: prices-2026-11-07-001" -H "Content-Type: application/json" -d '{"dry_run":false,"items":[{"offer_id":"off_xxxxxxxxxxxxxxxx","price_cents":1450}]}'
GET /api/v1/seller/offers/{id}
One of your offers.
Auth: seller-scope API key or signed-in seller
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s "https://capydra.com/api/v1/seller/offers/off_xxxxxxxxxxxxxxxx" -H "Authorization: Bearer $OMK_SELLER_KEY"
POST /api/v1/seller/offers/{id}/price
New price you want to receive; commission and buyer price are recomputed.
Auth: seller-scope API key or signed-in seller
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s -X POST "https://capydra.com/api/v1/seller/offers/off_xxxxxxxxxxxxxxxx/price" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{"price_cents":1600}'
POST /api/v1/seller/offers/{id}/stock
Upload keys to a manual offer (encrypted; duplicates across the platform are refused; never echoed).
Auth: seller-scope API key or signed-in seller
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s -X POST "https://capydra.com/api/v1/seller/offers/off_xxxxxxxxxxxxxxxx/stock" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{"keys":["AAAAA-BBBBB-CCCCC","DDDDD-EEEEE-FFFFF"]}'
POST /api/v1/seller/offers/{id}/stock:upload
Big key upload (up to 10,000 keys) as a background job. Answers 202 with the job at once; poll GET /api/v1/seller/jobs/{id} until status is done or failed. Bad lines become per-item errors (index and error, never the key): key_too_long, duplicate_in_upload, already_stored. Keys waiting in a job count toward your daily key limit. At most 3 open jobs. All keys of one job form one key batch (batch_id).
Auth: seller-scope API key or signed-in seller
| Parameter | In | Description |
|---|---|---|
id * | path | string |
upload * | path | string |
curl -s -X POST "https://capydra.com/api/v1/seller/offers/off_xxxxxxxxxxxxxxxx/stock:upload" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Idempotency-Key: stock-2026-11-07-001" -H "Content-Type: application/json" -d '{"keys":["AAAAA-BBBBB-CCCCC","DDDDD-EEEEE-FFFFF"]}'
GET /api/v1/seller/jobs
Your upload jobs, newest first (kept 30 days).
Auth: seller-scope API key or signed-in seller
| Parameter | In | Description |
|---|---|---|
status | query | queued, running, done or failed. |
limit | query | Page size, 1-50 (default 20). |
offset | query | Items to skip. |
curl -s "https://capydra.com/api/v1/seller/jobs" -H "Authorization: Bearer $OMK_SELLER_KEY"
GET /api/v1/seller/jobs/{id}
One upload job: status, counts (received, accepted, processed, added, duplicates, rejected), the first 200 per-item errors, batch_id and the orders delivered from the new keys.
Auth: seller-scope API key or signed-in seller
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s "https://capydra.com/api/v1/seller/jobs/job_xxxxxxxxxxxxxxxx" -H "Authorization: Bearer $OMK_SELLER_KEY"
GET /api/v1/seller/orders
Orders of your offers, filtered to the key's kind (sandbox or live).
Auth: seller-scope API key or signed-in seller
| Parameter | In | Description |
|---|---|---|
status | query | Only orders with this status. |
limit | query | Page size, 1-50 (default 20). |
offset | query | Items to skip. |
curl -s "https://capydra.com/api/v1/seller/orders" -H "Authorization: Bearer $OMK_SELLER_KEY"
GET /api/v1/seller/mcp-audit
Every call of an MCP write tool made with your keys (dry runs and errors too), newest first, kept 90 days. Arguments and results are short summaries; product keys are never stored (a key list shows as a count).
Auth: seller-scope API key or signed-in seller
| Parameter | In | Description |
|---|---|---|
limit | query | Page size, 1-50 (default 20). |
offset | query | Items to skip. |
curl -s "https://capydra.com/api/v1/seller/mcp-audit" -H "Authorization: Bearer $OMK_SELLER_KEY"
GET /api/v1/seller/product-requests
Your product requests, newest first.
Auth: seller-scope API key or signed-in seller
| Parameter | In | Description |
|---|---|---|
status | query | open, added or declined. |
limit | query | Page size, 1-50 (default 20). |
offset | query | Items to skip. |
curl -s "https://capydra.com/api/v1/seller/product-requests" -H "Authorization: Bearer $OMK_SELLER_KEY"
POST /api/v1/seller/product-requests
Ask for a product we do not list yet. A person checks it; GET /api/v1/seller/product-requests shows the answer (added with product_id, or declined with a reason). 409 product_exists when a sure match exists. At most 20 open requests.
Auth: seller-scope API key or signed-in seller
curl -s -X POST "https://capydra.com/api/v1/seller/product-requests" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{"name":"Example Game Deluxe Edition","platform":"Steam","region":"EU","type":"game","steam_app_id":"123456","ean":"4012345678901","note":"Supplier invoice ready."}'
webhooks
Signed event calls to your server (Standard Webhooks format).
GET /api/v1/seller/webhooks
Your webhook endpoints and the event types you can subscribe to.
Auth: seller-scope API key or signed-in seller
curl -s "https://capydra.com/api/v1/seller/webhooks" -H "Authorization: Bearer $OMK_SELLER_KEY"
POST /api/v1/seller/webhooks
Register an https endpoint (at most 5). Calls are signed in the Standard Webhooks format: headers webhook-id, webhook-timestamp and webhook-signature = "v1," + base64 HMAC-SHA256 over "id.timestamp.body" with the base64 part of the secret (whsec_...). Drop calls older than 5 minutes and ids you have seen. Answer 2xx within 10 seconds; otherwise we retry after 5 min, 30 min, 2 h, 5 h, 10 h and 24 h. The secret is in this answer only. Each event carries the full current state; no buyer data is sent.
Auth: seller-scope API key or signed-in seller
curl -s -X POST "https://capydra.com/api/v1/seller/webhooks" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{"url":"https://example.com/omk-webhooks","events":["order.paid","order.refunded","offer.held"],"description":"shop bot"}'
GET /api/v1/seller/webhooks/deliveries
Delivery log, newest first (kept 30 days): status, attempts, last status code or error, next try.
Auth: seller-scope API key or signed-in seller
| Parameter | In | Description |
|---|---|---|
endpoint_id | query | Only this endpoint. |
status | query | pending, delivered or failed. |
event_type | query | Only this event type. |
limit | query | Page size, 1-50 (default 20). |
offset | query | Items to skip. |
curl -s "https://capydra.com/api/v1/seller/webhooks/deliveries?status=failed" -H "Authorization: Bearer $OMK_SELLER_KEY"
POST /api/v1/seller/webhooks/deliveries/{id}/retry
Send one event again now, with the same webhook-id.
Auth: seller-scope API key or signed-in seller
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s -X POST "https://capydra.com/api/v1/seller/webhooks/deliveries/1/retry" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{}'
POST /api/v1/seller/webhooks/{id}/test
Send a webhook.test event to this endpoint now and see the result (delivered, status_code, error).
Auth: seller-scope API key or signed-in seller
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s -X POST "https://capydra.com/api/v1/seller/webhooks/whe_xxxxxxxxxxxxxxxx/test" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{}'
POST /api/v1/seller/webhooks/{id}/rotate-secret
New secret (in this answer only). For overlap_hours (default 24, max 168) every call carries both signatures, so you can switch without missing events.
Auth: seller-scope API key or signed-in seller
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s -X POST "https://capydra.com/api/v1/seller/webhooks/whe_xxxxxxxxxxxxxxxx/rotate-secret" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{"overlap_hours":24}'
POST /api/v1/seller/webhooks/{id}/disable
Stop sending to this endpoint. An endpoint that fails 100 tries in a row is disabled by itself.
Auth: seller-scope API key or signed-in seller
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s -X POST "https://capydra.com/api/v1/seller/webhooks/whe_xxxxxxxxxxxxxxxx/disable" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{}'
POST /api/v1/seller/webhooks/{id}/enable
Send to this endpoint again (the failure count starts at 0).
Auth: seller-scope API key or signed-in seller
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s -X POST "https://capydra.com/api/v1/seller/webhooks/whe_xxxxxxxxxxxxxxxx/enable" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{}'
POST /api/v1/seller/webhooks/{id}/delete
Delete the endpoint and its delivery log.
Auth: seller-scope API key or signed-in seller
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s -X POST "https://capydra.com/api/v1/seller/webhooks/whe_xxxxxxxxxxxxxxxx/delete" -H "Authorization: Bearer $OMK_SELLER_KEY" -H "Content-Type: application/json" -d '{}'
mcp
Model Context Protocol endpoint for AI assistants.
POST /mcp
MCP server (Streamable HTTP, stateless JSON-RPC). Buyer tools for every key; seller tools only for seller-scope keys. Send Accept: application/json, text/event-stream.
Auth: API key (Bearer) or signed-in session
curl -s -X POST "https://capydra.com/mcp" -H "Authorization: Bearer $OMK_KEY" -H "Accept: application/json, text/event-stream" -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
admin
Admin session only (API keys never carry the admin role).
GET /api/v1/orders/{id}/ledger
The ledger journals of one order (admin).
Auth: admin session (not available to API keys)
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s "https://capydra.com/api/v1/orders/ord_xxxxxxxxxxxxxxxx/ledger" -b "omk_session=$OMK_SESSION"
GET /api/v1/house/queue
Paid house-seller orders waiting for a key (admin).
Auth: admin session (not available to API keys)
curl -s "https://capydra.com/api/v1/house/queue" -b "omk_session=$OMK_SESSION"
POST /api/v1/house/orders/{id}/key
The house seller delivers: { key } | { keys: [...] } | { from_stock: true } (admin).
Auth: admin session (not available to API keys)
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s -X POST "https://capydra.com/api/v1/house/orders/ord_xxxxxxxxxxxxxxxx/key" -b "omk_session=$OMK_SESSION" -H "Content-Type: application/json" -d '{"from_stock":true}'
GET /api/v1/admin/payouts
Payouts and the balances due (admin).
Auth: admin session (not available to API keys)
| Parameter | In | Description |
|---|---|---|
seller_id | query | Only this seller. |
status | query | pending, done or failed. |
curl -s "https://capydra.com/api/v1/admin/payouts" -b "omk_session=$OMK_SESSION"
POST /api/v1/admin/payouts
Pay one seller now (admin).
Auth: admin session (not available to API keys)
curl -s -X POST "https://capydra.com/api/v1/admin/payouts" -b "omk_session=$OMK_SESSION" -H "Content-Type: application/json" -d '{"seller_id":"sel_xxxxxxxxxxxxxxxx"}'
POST /api/v1/admin/sellers/{id}/approve
Approve a seller's onboarding (admin).
Auth: admin session (not available to API keys)
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s -X POST "https://capydra.com/api/v1/admin/sellers/sel_xxxxxxxxxxxxxxxx/approve" -b "omk_session=$OMK_SESSION" -H "Content-Type: application/json" -d '{"note":"ID and address checked."}'
POST /api/v1/admin/sellers/{id}/reject
Reject a seller's onboarding with a reason the seller is told (admin).
Auth: admin session (not available to API keys)
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s -X POST "https://capydra.com/api/v1/admin/sellers/sel_xxxxxxxxxxxxxxxx/reject" -b "omk_session=$OMK_SESSION" -H "Content-Type: application/json" -d '{"reason":"The ID document is not readable."}'
other
Routes of other modules without their own documentation entry.
GET /api/v1/keys/usage
GET /api/v1/keys/usage (added by another module; no description yet).
Auth: API key (Bearer) or signed-in session
curl -s "https://capydra.com/api/v1/keys/usage" -H "Authorization: Bearer $OMK_KEY"
GET /api/v1/catalog/products
GET /api/v1/catalog/products (added by another module; no description yet).
Auth: API key (Bearer) or signed-in session
curl -s "https://capydra.com/api/v1/catalog/products" -H "Authorization: Bearer $OMK_KEY"
GET /api/v1/catalog/products/{id}
GET /api/v1/catalog/products/:id (added by another module; no description yet).
Auth: API key (Bearer) or signed-in session
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s "https://capydra.com/api/v1/catalog/products/<id>" -H "Authorization: Bearer $OMK_KEY"
GET /api/v1/purchase/balance
GET /api/v1/purchase/balance (added by another module; no description yet).
Auth: API key (Bearer) or signed-in session
curl -s "https://capydra.com/api/v1/purchase/balance" -H "Authorization: Bearer $OMK_KEY"
GET /api/v1/purchase/orders
GET /api/v1/purchase/orders (added by another module; no description yet).
Auth: API key (Bearer) or signed-in session
curl -s "https://capydra.com/api/v1/purchase/orders" -H "Authorization: Bearer $OMK_KEY"
POST /api/v1/purchase/orders
POST /api/v1/purchase/orders (added by another module; no description yet).
Auth: API key (Bearer) or signed-in session
curl -s -X POST "https://capydra.com/api/v1/purchase/orders" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{}'
GET /api/v1/purchase/orders/{id}
GET /api/v1/purchase/orders/:id (added by another module; no description yet).
Auth: API key (Bearer) or signed-in session
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s "https://capydra.com/api/v1/purchase/orders/<id>" -H "Authorization: Bearer $OMK_KEY"
POST /api/v1/purchase/orders/{id}/keys
POST /api/v1/purchase/orders/:id/keys (added by another module; no description yet).
Auth: API key (Bearer) or signed-in session
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s -X POST "https://capydra.com/api/v1/purchase/orders/<id>/keys" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{}'
GET /api/v1/seller/reservations
GET /api/v1/seller/reservations (added by another module; no description yet).
Auth: API key (Bearer) or signed-in session
curl -s "https://capydra.com/api/v1/seller/reservations" -H "Authorization: Bearer $OMK_KEY"
GET /api/v1/webhooks
GET /api/v1/webhooks (added by another module; no description yet).
Auth: API key (Bearer) or signed-in session
curl -s "https://capydra.com/api/v1/webhooks" -H "Authorization: Bearer $OMK_KEY"
POST /api/v1/webhooks
POST /api/v1/webhooks (added by another module; no description yet).
Auth: API key (Bearer) or signed-in session
curl -s -X POST "https://capydra.com/api/v1/webhooks" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{}'
GET /api/v1/webhooks/deliveries
GET /api/v1/webhooks/deliveries (added by another module; no description yet).
Auth: API key (Bearer) or signed-in session
curl -s "https://capydra.com/api/v1/webhooks/deliveries" -H "Authorization: Bearer $OMK_KEY"
POST /api/v1/webhooks/deliveries/{id}/retry
POST /api/v1/webhooks/deliveries/:id/retry (added by another module; no description yet).
Auth: API key (Bearer) or signed-in session
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s -X POST "https://capydra.com/api/v1/webhooks/deliveries/<id>/retry" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{}'
POST /api/v1/webhooks/{id}/test
POST /api/v1/webhooks/:id/test (added by another module; no description yet).
Auth: API key (Bearer) or signed-in session
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s -X POST "https://capydra.com/api/v1/webhooks/<id>/test" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{}'
POST /api/v1/webhooks/{id}/rotate-secret
POST /api/v1/webhooks/:id/rotate-secret (added by another module; no description yet).
Auth: API key (Bearer) or signed-in session
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s -X POST "https://capydra.com/api/v1/webhooks/<id>/rotate-secret" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{}'
POST /api/v1/webhooks/{id}/disable
POST /api/v1/webhooks/:id/disable (added by another module; no description yet).
Auth: API key (Bearer) or signed-in session
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s -X POST "https://capydra.com/api/v1/webhooks/<id>/disable" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{}'
POST /api/v1/webhooks/{id}/enable
POST /api/v1/webhooks/:id/enable (added by another module; no description yet).
Auth: API key (Bearer) or signed-in session
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s -X POST "https://capydra.com/api/v1/webhooks/<id>/enable" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{}'
POST /api/v1/webhooks/{id}/delete
POST /api/v1/webhooks/:id/delete (added by another module; no description yet).
Auth: API key (Bearer) or signed-in session
| Parameter | In | Description |
|---|---|---|
id * | path | string |
curl -s -X POST "https://capydra.com/api/v1/webhooks/<id>/delete" -H "Authorization: Bearer $OMK_KEY" -H "Content-Type: application/json" -d '{}'