curl -X POST https://win.oneshotagent.com/v1/tools/lookup/protein-structure \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"accession": "P04637",
"coverage": "experimental",
"limit": 2
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/protein-structure", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"accession": "P04637",
"coverage": "experimental",
"limit": 2
}),
});
const result = await agent.tool('lookup/protein-structure', {
accession: 'P04637',
coverage: 'experimental',
limit: 2
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "protein_structure",
"result": {
"coverage": "experimental",
"experimental": {
"total": 323,
"structures": [
{
"pdb_id": "9U4D",
"title": "Structure of UBE3A-E6-p53 complex",
"method": "ELECTRON MICROSCOPY",
"resolution_angstrom": 3.39,
"released_on": "2026-09-23",
"page_url": "https://www.rcsb.org/structure/9U4D",
"file_url": "https://files.rcsb.org/download/9U4D.cif"
},
{
"pdb_id": "21EX",
"title": "Wild tipe p53WT-HLA-A2",
"method": "X-RAY DIFFRACTION",
"resolution_angstrom": 2.021,
"released_on": "2026-09-09",
"page_url": "https://www.rcsb.org/structure/21EX",
"file_url": "https://files.rcsb.org/download/21EX.cif"
}
]
}
},
"evidence": {
"source": "RCSB Protein Data Bank; EMBL-EBI",
"source_kind": "public",
"retrieved_at": "2026-10-15T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-15T12:00:00.000Z"
},
{
"retrieved_at": "2026-10-15T12:00:00.000Z"
}
],
"as_of": "2026-09-23"
}
}
}
Life sciences
Protein Structure
Give the experimental structures or the predicted model of a protein by its UniProt accession.
POST
/
v1
/
tools
/
lookup
/
protein-structure
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/protein-structure \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"accession": "P04637",
"coverage": "experimental",
"limit": 2
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/protein-structure", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"accession": "P04637",
"coverage": "experimental",
"limit": 2
}),
});
const result = await agent.tool('lookup/protein-structure', {
accession: 'P04637',
coverage: 'experimental',
limit: 2
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "protein_structure",
"result": {
"coverage": "experimental",
"experimental": {
"total": 323,
"structures": [
{
"pdb_id": "9U4D",
"title": "Structure of UBE3A-E6-p53 complex",
"method": "ELECTRON MICROSCOPY",
"resolution_angstrom": 3.39,
"released_on": "2026-09-23",
"page_url": "https://www.rcsb.org/structure/9U4D",
"file_url": "https://files.rcsb.org/download/9U4D.cif"
},
{
"pdb_id": "21EX",
"title": "Wild tipe p53WT-HLA-A2",
"method": "X-RAY DIFFRACTION",
"resolution_angstrom": 2.021,
"released_on": "2026-09-09",
"page_url": "https://www.rcsb.org/structure/21EX",
"file_url": "https://files.rcsb.org/download/21EX.cif"
}
]
}
},
"evidence": {
"source": "RCSB Protein Data Bank; EMBL-EBI",
"source_kind": "public",
"retrieved_at": "2026-10-15T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-15T12:00:00.000Z"
},
{
"retrieved_at": "2026-10-15T12:00:00.000Z"
}
],
"as_of": "2026-09-23"
}
}
}
Give the structure of a protein by its UniProt accession.
coverage picks which kind: experimental lists the newest entries in the Protein Data Bank that contain the protein, each with its title, experimental method, resolution in angstrom, release date, page and structure file, with total counting every matching entry; predicted returns the predicted model for the accession, with its version, creation date, residue range, mean confidence, the fraction of residues at each confidence level, and its structure and error-image files, or null when no model exists. A predicted model is a computed estimate with per-residue confidence, not an experimental structure: regions of low or very low confidence should not be read as structure. Predicted models come from the predicted-structure database at EMBL-EBI, used under CC BY 4.0; experimental entries come from the RCSB Protein Data Bank. Use it to check whether a protein has a solved structure, to find the file to load into a viewer or a docking run, or to judge how far a predicted model can be trusted. Covers proteins with a UniProt accession. The sequence, alignment links and the names of the prediction software and its maker are not returned.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
string
required
The UniProt accession of the protein, for example P04637. A UniProt accession is 6 or 10 letters and digits in the UniProt form.
string
required
Which kind of structure: experimental (entries in the Protein Data Bank) or predicted (the predicted model). One of
experimental, predicted.integer
How many experimental structures to return, newest release first (1 to 25). Ignored for predicted. From 1 to 25. Defaults to
10.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:
completedstring
Always
protein_structureobject
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always
RCSB Protein Data Bank; EMBL-EBI.string
public when the data comes from a public body, commercial otherwisestring
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 dateResult
Nested underdata.result.
string
The kind of structure returned: the
coverage asked for.object
The experimental structures; present when
coverage is experimental.integer
How many Protein Data Bank entries contain the protein, including any beyond
limit.object[]
The newest entries first, at most
limit.string
The Protein Data Bank identifier of the entry, for example 9U4D.
string
The title of the entry.
null when the source gives no value.string
The experimental method, for example X-RAY DIFFRACTION or ELECTRON MICROSCOPY.
null when the source gives no value.number
The resolution in angstrom, or null when the method has none.
string
The date the entry was released (YYYY-MM-DD).
null when the source gives no value.string
The entry page at the Protein Data Bank.
string
The structure file of the entry (mmCIF).
object
The predicted model, a computed prediction, or null when no model exists; present when
coverage is predicted.string
The identifier of the predicted model, for example AF-P04637-F1.
integer
The latest version of the model.
null when the source gives no value.string
The date the model was created (YYYY-MM-DD).
null when the source gives no value.integer
The first residue the model covers.
integer
The last residue the model covers.
number
The mean per-residue confidence of the model, 0 to 100.
object
How the residues split by confidence level, as fractions of 1.
number
The fraction of residues with very high confidence (above 90).
number
The fraction of residues with confidence 70 to 90.
number
The fraction of residues with confidence 50 to 70.
number
The fraction of residues with confidence below 50.
string
The model file (mmCIF).
null when the source gives no value.string
The model file in PDB format.
null when the source gives no value.string
The predicted aligned error plot of the model.
null when the source gives no value.curl -X POST https://win.oneshotagent.com/v1/tools/lookup/protein-structure \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"accession": "P04637",
"coverage": "experimental",
"limit": 2
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/protein-structure", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"accession": "P04637",
"coverage": "experimental",
"limit": 2
}),
});
const result = await agent.tool('lookup/protein-structure', {
accession: 'P04637',
coverage: 'experimental',
limit: 2
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "protein_structure",
"result": {
"coverage": "experimental",
"experimental": {
"total": 323,
"structures": [
{
"pdb_id": "9U4D",
"title": "Structure of UBE3A-E6-p53 complex",
"method": "ELECTRON MICROSCOPY",
"resolution_angstrom": 3.39,
"released_on": "2026-09-23",
"page_url": "https://www.rcsb.org/structure/9U4D",
"file_url": "https://files.rcsb.org/download/9U4D.cif"
},
{
"pdb_id": "21EX",
"title": "Wild tipe p53WT-HLA-A2",
"method": "X-RAY DIFFRACTION",
"resolution_angstrom": 2.021,
"released_on": "2026-09-09",
"page_url": "https://www.rcsb.org/structure/21EX",
"file_url": "https://files.rcsb.org/download/21EX.cif"
}
]
}
},
"evidence": {
"source": "RCSB Protein Data Bank; EMBL-EBI",
"source_kind": "public",
"retrieved_at": "2026-10-15T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-10-15T12:00:00.000Z"
},
{
"retrieved_at": "2026-10-15T12:00:00.000Z"
}
],
"as_of": "2026-09-23"
}
}
}
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}