Skip to content
FoxLeague Manual

Save your starting eleven and bench

POST
/api/teams/lineup
 
curl --request POST \
  --url https://foxleague.ai/api/teams/lineup \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "lineup": [ 1 ], "substitutes": [ 1 ], "wallet_address": "example" }'

Saves your 11 starters and 7 substitutes and answers the team. Send up to 7 substitutes: a shorter bench is filled from your other cards, strongest first, leaving out cards listed for sale or still in a transfer cooldown. Every card must be yours and not listed for sale.

Who: a signed-in player with a team.

Refusals:

  • Lineup must have exactly 11 players: lineup does not hold 11 nonces.
  • Substitutes cannot exceed 7 players: substitutes holds more than 7 nonces.
  • User not found: the wallet has no account.
  • Team must have exactly 11 starters + 7 substitutes. You picked <n> sub(s) and have only <r> eligible reserve(s). Acquire <x> more NFT(s) to complete the bench.: you do not have enough cards for a full bench.
  • Some players are not owned by you or are listed for sale: a card is not yours, is listed for sale or appears twice.
  • Cooldown active for recently-transferred players: <name> (<time left>), ...: a card received from another wallet is still in its transfer cooldown. The time left reads like 3d 4h or 5h 12m.

A wallet without a team gets HTTP 404 with an empty body. If the lineup cannot be saved on our side, the answer is HTTP 500 with an empty body.

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
Media type application/json

The starting eleven and bench to save.

object
lineup
required

NFT nonces of the 11 starters.

Array<integer>
substitutes

NFT nonces of up to 7 substitutes. A shorter bench is filled from your other cards.

Array<integer>
wallet_address
required

Your wallet address. The body needs it, but the session decides which team changes.

string
Example generated
{
  "lineup": [
    1
  ],
  "substitutes": [
    1
  ],
  "wallet_address": "example"
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Success or a refusal: read success (the refusals are in the description).

Media type application/json
object
code

A machine-readable reason next to error, set only where the caller must act differently. tx_pending: the payment was not refused but could not be verified yet; keep the transaction hash and confirm again with the same hash, never pay twice.

string | null
data

The answer. Present when success is true.

object
badge

The team badge, usually an ipfs:// address (some older teams carry an inline image); null when none.

string | null
badge_ipfs_uri

The badge’s ipfs:// address; null when none.

string | null
coach_name

The coach name; null when not set.

string | null
created_at
required

When the team was created (RFC 3339).

string format: date-time
formation
required

The saved formation.

string
id
required

Team id.

integer format: int32
lineup
required

NFT nonces of the 11 starters, as an array. Empty until a lineup is saved.

name
required

Team name.

string
substitutes
required

NFT nonces of the bench, as an array.

team_overall

Average of the starters’ seven attributes; null until a lineup is saved.

number | null format: double
user_id
required

The owner’s user id.

integer format: int32
verified
required

true when the team carries the verified mark.

boolean
error

Why the request was refused, in plain words. Present when success is false.

string | null
success
required

true when the request did what it asked. false is a refusal: read error.

boolean
Example 
{
  "data": {
    "badge": "ipfs://bafybeihkoviema7g3gxyt6la7vd5ho32ictqbilu3wnlo3rs7ewhnp7lly",
    "badge_ipfs_uri": "ipfs://bafybeihkoviema7g3gxyt6la7vd5ho32ictqbilu3wnlo3rs7ewhnp7lly",
    "coach_name": "Ada Moraru",
    "created_at": "2026-09-16T08:02:44.517093Z",
    "formation": "4-3-3",
    "id": 398,
    "lineup": [
      1301,
      1234,
      1240,
      1255,
      1262,
      1270,
      1288,
      1290,
      1302,
      1311,
      1325
    ],
    "name": "Fox Rovers",
    "substitutes": [
      1330,
      1342,
      1356,
      1361,
      1377,
      1389,
      1394
    ],
    "team_overall": 47.25,
    "user_id": 412,
    "verified": false
  },
  "success": true
}

401

Section titled “401 ”

No valid session. The body is plain text: Missing Authorization header, Invalid Authorization format, Invalid session token or Session expired or invalid. Sign in again.

Media type text/plain
string
Example 
Session expired or invalid

404

Section titled “404 ”

The wallet has no team yet. The body is empty.

500

Section titled “500 ”

The lineup could not be saved on our side. The body is empty.