Protein Function

curl -X POST https://win.oneshotagent.com/v1/tools/lookup/protein-function \
  -H "Content-Type: application/json" \
  -H "payment-signature: <base64 x402 payment>" \
  -d '{
    "accession": "P29358",
    "include_sequence": false
  }'

const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/protein-function", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "payment-signature": paymentProof,
  },
  body: JSON.stringify({
    "accession": "P29358",
    "include_sequence": false
  }),
});

const result = await agent.tool('lookup/protein-function', {
  accession: 'P29358',
  include_sequence: false
});
console.log(result.data.result);
console.log(result.data.evidence);

{
  "success": true,
  "data": {
    "request_id": "uuid",
    "receipt_id": "rcpt_...",
    "status": "completed",
    "tool": "protein_function",
    "result": {
      "protein": null,
      "inactive_reason": {
        "reason_type": "DEMERGED",
        "replacement_accessions": [
          "P68251",
          "P68250"
        ]
      }
    },
    "evidence": {
      "source": "UniProt Consortium",
      "source_kind": "public",
      "retrieved_at": "2026-01-15T12:00:00.000Z",
      "calls": [
        {
          "retrieved_at": "2026-01-15T12:00:00.000Z"
        }
      ],
      "as_of": null
    }
  }
}

POST

tools

lookup

protein-function

curl -X POST https://win.oneshotagent.com/v1/tools/lookup/protein-function \
  -H "Content-Type: application/json" \
  -H "payment-signature: <base64 x402 payment>" \
  -d '{
    "accession": "P29358",
    "include_sequence": false
  }'

const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/protein-function", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "payment-signature": paymentProof,
  },
  body: JSON.stringify({
    "accession": "P29358",
    "include_sequence": false
  }),
});

const result = await agent.tool('lookup/protein-function', {
  accession: 'P29358',
  include_sequence: false
});
console.log(result.data.result);
console.log(result.data.evidence);

{
  "success": true,
  "data": {
    "request_id": "uuid",
    "receipt_id": "rcpt_...",
    "status": "completed",
    "tool": "protein_function",
    "result": {
      "protein": null,
      "inactive_reason": {
        "reason_type": "DEMERGED",
        "replacement_accessions": [
          "P68251",
          "P68250"
        ]
      }
    },
    "evidence": {
      "source": "UniProt Consortium",
      "source_kind": "public",
      "retrieved_at": "2026-01-15T12:00:00.000Z",
      "calls": [
        {
          "retrieved_at": "2026-01-15T12:00:00.000Z"
        }
      ],
      "as_of": null
    }
  }
}

Protein annotations from UniProt under CC BY 4.0, attributed to the UniProt Consortium. Covers reviewed and unreviewed UniProtKB entries. Function texts retain their literature citations, with deduplicated PubMed identifiers also returned separately. Includes names, genes, organism, length, subcellular locations, catalytic activities, EC numbers, keywords and annotation score. UniProt releases updates every eight weeks; last_updated is the entry’s last annotation date. The amino-acid sequence is returned only when include_sequence is true, otherwise null. Absent values and collections are null. A merged accession resolves to its primary entry. A deleted or demerged accession returns no protein and the source’s structured inactive reason, including replacement accessions when supplied. No match returns null for both.

Authentication

Requires x402 payment in the payment-signature header.

Request Body

string

required

The UniProt accession identifying the protein, for example P04637.

boolean

Include the amino-acid sequence. Defaults to false.

Response (200 OK)

Top-level envelope: success (boolean) and data (object). All fields below are nested under data.

string

Durable job ID for audit and lookup

string

Job status: completed

string

Always protein_function

object

The answer, described under Result below

object

Where the answer came from and when

string

The public body the data comes from. Always UniProt Consortium.

string

public when the data comes from a public body, commercial otherwise

string

When the lookup was made, as an ISO 8601 UTC time

string

When the source says the fact was last updated, or null when the source gives no date

Result

Nested under data.result.

object

Protein. null when the source gives no value.

string

Accession. null when the source gives no value.

string

Entry name. null when the source gives no value.

boolean

Reviewed. null when the source gives no value.

string

Protein name. null when the source gives no value.

string[]

Alternative names. null when the source gives no value.

object[]

Genes. null when the source gives no value.

string

Name. null when the source gives no value.

string[]

Synonyms. null when the source gives no value.

object

Organism. null when the source gives no value.

string

Scientific name. null when the source gives no value.

number

Taxon id. null when the source gives no value.

number

Length. null when the source gives no value.

string[]

FUNCTION comment texts, retaining the source’s literature citations. null when the source gives no value.

string[]

Distinct PubMed identifiers from FUNCTION text evidences. null when the source gives no value.

object[]

Subcellular locations. null when the source gives no value.

string

Location. null when the source gives no value.

string

Isoform. null when the source gives no value.

object[]

Catalytic activities. null when the source gives no value.

string

Reaction. null when the source gives no value.

string

Ec. null when the source gives no value.

string[]

Ec numbers. null when the source gives no value.

object[]

Keywords. null when the source gives no value.

string

Id. null when the source gives no value.

string

Category. null when the source gives no value.

string

Name. null when the source gives no value.

number

Annotation score. null when the source gives no value.

string

Last annotation update date, YYYY-MM-DD. null when the source gives no value.

string

Amino-acid sequence, only when requested. null when the source gives no value.

object

Inactive reason. null when the source gives no value.

string

The source’s reason for inactivation, for example DELETED or DEMERGED. null when the source gives no value.

string[]

Replacement accessions for a demerged entry. null when the source gives no value.

curl -X POST https://win.oneshotagent.com/v1/tools/lookup/protein-function \
  -H "Content-Type: application/json" \
  -H "payment-signature: <base64 x402 payment>" \
  -d '{
    "accession": "P29358",
    "include_sequence": false
  }'

const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/protein-function", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "payment-signature": paymentProof,
  },
  body: JSON.stringify({
    "accession": "P29358",
    "include_sequence": false
  }),
});

const result = await agent.tool('lookup/protein-function', {
  accession: 'P29358',
  include_sequence: false
});
console.log(result.data.result);
console.log(result.data.evidence);

{
  "success": true,
  "data": {
    "request_id": "uuid",
    "receipt_id": "rcpt_...",
    "status": "completed",
    "tool": "protein_function",
    "result": {
      "protein": null,
      "inactive_reason": {
        "reason_type": "DEMERGED",
        "replacement_accessions": [
          "P68251",
          "P68250"
        ]
      }
    },
    "evidence": {
      "source": "UniProt Consortium",
      "source_kind": "public",
      "retrieved_at": "2026-01-15T12:00:00.000Z",
      "calls": [
        {
          "retrieved_at": "2026-01-15T12:00:00.000Z"
        }
      ],
      "as_of": null
    }
  }
}

See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers 200.

Notes

Results return inline. The finished job stays available at /v1/requests/{request_id}

Overview

Compute

Data

Monitoring

Research & Enrich

Messaging

Web & Browser

Build

Commerce

Account & billing

Other

Protein Function

Authentication

Request Body

Response (200 OK)

Result

Notes

​Authentication

​Request Body

​Response (200 OK)

​Result

​Notes

Authentication

Request Body

Response (200 OK)

Result

Notes