Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Icarehub Xyz Predictions API
version: 1.0.0
contact:
email: protocole@icarehub.xyz
x-guidance: GET /api/observed lists the followed matches with their Win/Lose prices (status 3 and observed.inProgress = open, before observed.closesAt). GET /api/agents/config gives the chain, USDC, match contract and fees. To take a position, sign an ICARE Portfolio action calling placePrediction(matchId, outcome, stake) (outcome 0 = Win, 1 = Lose, stake 1.00 to 50.00 USDC in 6-decimal units), POST it to /api/agents/bets, then pay the returned x402 challenge (stake + 0.20 USDC) with an EIP-3009 authorization. The open-source MCP server (npx -y github:Djangode/icare-mcp) does all of this for an agent wallet.
description: 'Operations tagged Predictions across 2 of this provider''s published API definitions: openapi.json, icarehub-xyz-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.icarehub.xyz
tags:
- name: Predictions
paths:
/api/agents/bets:
post:
operationId: placePrediction
summary: Take a Win/Lose position on a live followed esports match
tags:
- Predictions
x-payment-info:
price:
mode: dynamic
currency: USD
min: '1.20'
max: '50.20'
protocols:
- x402: {}
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
matchId:
type: string
pattern: ^[1-9][0-9]*$
description: Match id from GET /api/observed
outcome:
type: integer
enum:
- 0
- 1
description: 0 = Win, 1 = Lose (the streamer)
stake:
type: string
pattern: ^[0-9]+$
description: USDC stake in 6-decimal units (1000000 to 50000000)
action:
type: object
description: 'ICARE Portfolio action signed by the agent wallet: placePrediction(matchId, outcome, stake) on the match contract'
properties:
account:
type: string
target:
type: string
value:
type: string
relayFee:
type: string
nonce:
type: string
deadline:
type: string
data:
type: string
required:
- account
- target
- value
- relayFee
- nonce
- deadline
- data
signature:
type: string
description: Signature of the Portfolio action digest
required:
- matchId
- outcome
- stake
- action
- signature
responses:
'200':
description: Position placed
content:
application/json:
schema:
type: object
properties:
status:
type: string
paymentNonce:
type: string
matchId:
type: string
outcome:
type: integer
stake:
type: string
paymentTx:
type: string
depositTx:
type: string
betTx:
type: string
required:
- status
- paymentNonce
- matchId
- outcome
- stake
- paymentTx
- depositTx
- betTx
'400':
description: Invalid request
'402':
description: 'Payment Required (x402 v2, exact, USDC): stake + network fees'
'409':
description: Market closed
servers:
- url: https://api.icarehub.xyz
x-refined-from:
- openapi.json
- icarehub-xyz-openapi.json
x-provenance:
method: harvested
publisher: ICARE Arena
source: https://api.icarehub.xyz/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)